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Introduction 


Overview 


The Meridian Administration Tools (MAT) provide the Meridian 1 system 
administrator with powerful tools for maintaining and updating the 
Meridian | system. The MAT system consists of MAT Common Services 
and several MAT applications, each of which provides specific system 
management capabilities. This User Guide describes the MAT Station 
Administration application. 


The Station Administration application helps administer databases that define 
end-user stations (telephones) on Northern Telecom Meridian | systems. The 
Station Administration application contains the following modules: 


Station Administration 
This module allows you to change station data on an individual or 
selected group basis. 

CPND 
This module allows you to manage Call Party Name Display (CPND) 
data. 

Report Generator 
This module allows you to create and produce standard or customized 
reports. 

Conversion Utility 
This module provides import and file rebuild capabilities. 


Communications 
This module synchronizes MAT and Meridian 1 data (copies MAT data 
to Meridian 1 or copies Meridian 1 data to MAT). 
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MAT Users 


Introduction 


The MAT system is designed for managers of telecommunications equipment 
and authorized Northern Telecom distributors. This guide is intended for 
users who have a working knowledge of Meridian | systems and general 
telecommunications concepts. 


This guide assumes you are familiar with PC systems and the Microsoft 


Windows™ environment. You should be familiar with the Windows 


environment before attempting to use the MAT system. 


Conventions used in this manual 


This manual uses the following terms: 


e Computer system refers to the hardware and software of an IBM-PC™ or 
100% IBM compatible PC. 


e Disk refers to a high capacity hard disk, required by the MAT system. 


e Windows refers to Microsoft Windows™ 95 and Windows NT 
Workstation 4.0. 


e Mouse refers to any standard PC pointing device. Common mouse 
actions include point, click, and double-click. 


e Standard Windows terminology includes icon, window, dialog box, and 
menu. 


This manual uses the following typographical conventions: 


e Angle brackets denote a single keyboard key. For example, <Esc> 
denotes the Escape key, labeled Esc on PC keyboards. A series of angle 
brackets denote keyboard keys to use simultaneously. For example, 
<Ctrl> SAL Del” denotes the key sequence for rebooting a PC. 


e This font is used to designate menu selections, buttons, and commands 
to enter. 
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Getting started 


Before you can start using MAT Station Administration, you must retrieve 
station, customer, and other associated data files from the Meridian 1. The 
following summarizes the steps to follow before you can use MAT Station 
Administration. 


Ensure site and system information is defined 


The properties of sites and systems must be defined before you can use 
Station Administration. See the Common Services User Guide for detailed 
procedures. 


Define site properties in the New Site Properties sheet. 


Define system properties in the System Properties dialog box. Be sure to 
completely define information in the following tabs 


General tab: include system name and short name 
Communications tab: include at least one communications profile 


Applications tab: be sure to enable the Station Administration 
application and a corresponding communication profile 


Customers tab: be sure to add at least one customer (usually 
Customer 0) and define this customer’s properties to include a 
customer name, user ID, and password. You'll have to define unique 
names, IDs and passwords for each customer added. 


Numbering Plans tab: define a numbering plan for each customer 
using the Numbering Plans tab found under the Customer Properties 
sheet. Station Administration uses information entered here to 
provide a list of available extensions (DNs) and will validate the 
extensions against the applicable feature (e.g., ACD DN). 
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Once defined, sites and systems appear as icons in the MAT Navigator and 
System windows. 


Update the system data 
Open the System window. Click on the system icon and choose Update 


System Data. The following dialog box appears. See Figure 1. 


Figure 1 
Update system data dialog box 


Sample Site - test name - Update System Data 


Compare the data stored in the PC with the 
actual system data, and log differences in the 


PC Event Log 
Cancel | 
(* Update the data stored in the PC "E 
Help | 


C Compare only 





(* Doit now 


C Schedule for later: 





Month 
B5 














Click OK to update the system data. 


Retrieve customer station data 


Open the System window. View the applications available for the system you 
have defined and open the Station Administration application under the 
Stations icon. With the Station Administration window open, retrieve station 
data for each customer on the system. Choose Synchronize-Retrieve-All 
from the menu bar. 


Repeat this step for each customer on the system. 
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Retrieve Reserve Unit TNs 


With the Station Administration window open, retrieve Reserve Unit TN 
information. Choose Synchronize-Retrieve-Reserve Unit TNs. The 
Synchronization window appears. Click OK to begin retrieval. 


Retrieve CPND configuration 


Open the System window. View the applications available for the system you 
have defined and open the CPND application under the Stations icon. The 
CPND Name window appears listing names of users on the system. Choose 
View-CPND from the menu bar. The CPND window appears. 


Choose Synchronize-Retrieve-Specify from the menu bar. The Call Party 
Name Display Retrieve window appears. Enter the customer number. Click 
OK. The Synchronization window appears. Click OK to begin retrieval. 


Retrieve CPND names 


With the CPND window open, choose View-CPND Name. The CPND Name 
window appears. With the CPND Name window open, retrieve CPND data 

for each customer on the system. Choose Synchronize-Retrieve-All from the 
menu bar. The Synchronization window appears. Click OK to begin retrieval. 


Repeat this step for each customer on the system. 


Additional considerations 


While getting started with Station Administration, you will be 
communicating with the Meridian 1 system. For further information, see 
“Communicating with Meridian 1” on page 97. 


Retrieving information from large systems can be time consuming and affect 
negatively system performance. You can use the Scheduler utility to plan 
when to perform these tasks, usually during hours when the number of users 
on the system are low, to minimize the effect of this operation on the system’s 
performance. 
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Station Administration 


Overview 


Before using MAT Station Administration, you must install and configure the 
software. Refer to MAT Common Services User Guide for installation 
instructions. 


MAT Station Administration supports creation, maintenance, change, and 
reporting of single and multi-line station data and Call Party Name Display 
(CPND) information. Station data defines the setup for each user (telephone) 
connected to the Meridian 1 system. 


Station data can be collected from the Meridian 1 system, or can be created 
within MAT. You can change this data within MAT and upload it to update 
the Meridian 1 database. 


Each system has a number of stations. You can set up each station 
individually. In practice, many stations will have features in common. All 
features of any station can be set individually, or in groups with common 
criteria. The Station Administration module lets you create many stations 
with identical features using templates. However, those features that can be 
considered unique for a station (such as DN, TN, name, and location) are 
accessible through a dialog that graphically represents the appearance of the 
instrument at that station. All other features are accessible from this dialog 
through function buttons. 


Station Data Considerations 


You should be aware of the following considerations when operating the 
Station Administration module: 
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Location 


DES 


The MAT application uses one field (Location) in the station database to 
identify and index a station record. Station data records are stored and 
retrieved by the value in this field. Since this is the primary identifier for a 
station within MAT, each station must be assigned a unique Location value. 
A new station cannot be created in MAT until you assign a unique Location 
value. Furthermore, Location is the only station record field that is required 
by MAT—see “DES” below. MAT validates this field during data entry and 
will not allow non-unique values or no value. 


The Location field is not stored in the Meridian 1 system. Data retrieved from 
Meridian 1 containing stations not currently defined in MAT will have the 
fully qualified Terminal Number field value (with dashes for separators 
instead of blanks) assigned to the Location field. You can edit this value to 
conform with your Location value rules. 


The DES field is a required field for station data residing on the Meridian 1. 
It is possible to create station data within MAT that has no DES field value 
(This 1-6 character designator value can be assigned through the 
Administration feature of the Features function in Station Administration). In 
such cases, MAT attempts to assign the first 6 characters of the Location 
value to DES. If this value contains non-alphanumeric values MAT leaves the 
DES field blank (Location can contain all Windows-acceptable characters, 
but DES can have only letters and numbers). 


Any station with no DES value will cause an error during transmission of 
MAT data to the Meridian 1. The Validation utility checks the DES and any 
other field values that can cause transmission failures. Refer to “Station Data 
Validation” on page 39. 


Meridian 1 station data retrieved from a system will always have a DES 
value. 
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Sync Status 


The Station list includes the current Synchronization status. Values include: 


e NEW: a station that has been created on MAT but not yet transmitted to 
the Meridian | system. 


e TRN: a station that has been synchronized with the Meridian 1 system. 
The MAT software has determined that the version of this station in the 
MAT PC database is consistent with the version of this station on the 
Meridian | system. 


e CHG, or RPL: a station that has been changed (or marked for 
replacement) on the Meridian | system. The MAT system has 
determined that the station has been updated on the MAT PC database 
and that the version on the Meridian 1 system does not yet reflect the 
MAT update activity. 


e OUT: a station that has been marked for deletion on the MAT PC 
database. It will not be deleted from the MAT PC database until the 
station has been OUTed (deleted) on the Meridian 1 system during a 
Synchronization/Transmit operation. A MAT user may update a station 
marked OUT. The MAT system will ask whether the station is to be 
restored before allowing you to update the station. 


The MAT Delete or Cut operation works slightly differently depending on 
the station’s synchronization status. A station marked NEW can be deleted 
immediately from the MAT PC database, since it has not been configured on 
the Meridian 1 system. A station with any other status is marked OUT, since 
the station must be OUTed on the Meridian 1 system before the station may 
actually be deleted from the MAT PC database. A station marked OUT will 
continue to appear in the list of stations until it has been successfully OUTed 
from the Meridian 1 system. A station with a status of OUT on the MAT PC 
database on which you apply Edit - Cut or Edit - Delete will continue to be 
marked OUT until it has been successfully synchronized. 
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Synchronization Considerations 


If the Station Administration module is in Maintenance mode (set from 
Options - Mode in Station Administration module), you are prompted to 
schedule data transmission to Meridian 1 when any modifications are made 
to the data stored in MAT. 


You can schedule synchronization when prompted, or schedule later. 


Reports and Text Files 


All log report activity is performed, by default, in the current working 
directory for the System (the system subdirectory in your PC system). Other 
reports are sent to the PC directory of your choice. Here is a list of text files 
with the appropriate extension found in the working directory: 


e Report Forms (filename.FRM) 

e Reports (filename.TXT) 

e Validation Data (you provide the extension) 

e Designation Strips (you provide the extension) 


e Communications Logs (filename.LOG) 


You need only supply the filename when prompted to save these files—MAT 
automatically supplies the appropriate extension. 


Parsing Retrieved Data 


Meridian 1 data retrieval is actually a two-stage task. MAT first retrieves the 
data to a file in the system subdirectory, then parses the file to conform with 
the MAT database rules. 


The switch connection is only required during the retrieval stage. If you are 
connected to the switch through a modem, MAT will disconnect the modem 
immediately after the retrieval and before the parse. The parsing takes place 
on the PC only. If you interrupt the parse, for example by turning off or 
rebooting the PC, it can be restarted by using Synchronization Retrieve - 
Parse Only. 
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Multi-Tenant 
If the TENA package is equipped, you must supply a tenant number (TEN). 


System Hardware 


During station data retrieval, the system hardware information is updated 
with cards that will support the type of stations being retrieved. This might 
not actually match the hardware used (although it will be compatible). If an 
exact match is required, you must manually update the hardware data in the 
Station Hardware view. 


Station Administration window 


When you start Station Administration, the MAT Station Administration 
window opens, allowing access to station data for a single Meridian 1 system. 
Here is the MAT Station Administration window as first displayed: 


Figure 2 
Station Administration window 
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The MAT security system allows the system administrator to make functions 
available on a user-by-user basis. Those menu items that are not available to 
you are shown dimmed. The menu bar contains the following drop-down 


menus: 
e File 
e Edit 
* View 


e Synchronize 


e Forms 

e Options 

e Help 
File Menu 


Use the File menu to access the station data of a selected system. 


Reports: Lets you design and generate reports based on existing station data. 
This item includes the Report Generator and two existing reports, as follows: 


e Bridges: a list of bridges on the system 


e Multiple appearances: a list of multiple-appearance stations 


Desig. Strip: Sends data for labeling buttons and keys on an instrument to a 
MAT viewer where you can browse and print the data. 


Print: Sends the station list to a MAT viewer (described in “Generating 
Reports" on page 121) where you can browse and print the data. Choose from 
the following display formats: 


e Short Format: one-page abbreviated list of station data 
e By Feature Group: station data by Feature Group 


e By Field Mnemonic: station data by Meridian 1 field mnemonic 
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Validate: Validates field values (all or partial, selectable in a submenu) for 
selected station records: 


e Partial: checks station records that, if incorrect, can cause a transmission 
failure during synchronization 


e Full: checks all station records 


Conversion Utility: Launches the conversion utility, used to update MAT 
data. For more information, see the Conversion Utility chapter. 


Close: Closes Station Administration and returns to the Meridian 
Administration Tools window. MAT automatically saves station updates as 
they are made. This means that you need not close an open system before 
quitting the application. 


Edit Menu 


Use the Edit menu to change data within an open system. Refer to the 
Common Services User Guide for details on Undo and Cut / Copy / Paste. 
The MAT-specific actions include: 


Add / Delete / Update: Adds/removes/modifies stations for the currently 


open system. 


Global Update / Select / Select All: Allows you to modify selected fields in 
a group of selected stations. 


User Field Names: Assigns names for the 10 user-defined fields for the 
current system. 


View Menu 


Use the View menu to choose the station data parameters you wish to view. 
The currently selected view is indicated by a check-mark against the menu 
selection and is displayed in the status bar of the main window. 


Station: This option displays a list of all stations defined for this system. 
When you choose an Edit function, the highlighted station record is opened. 
If none are defined, you can only choose Edit - Add. 


Template: This option accesses templates that contain station definitions that 
the open system may use frequently. 
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Hardware: This option displays line cards used in the system. The Reserve 
TN feature adds new fields in this view to reserve units on the supported card 


types. 


Sort: This option only appears when the Station view is selected. The list can 
be sorted by a criterion selected from a submenu that appears when you 
choose this item. The criteria include: 


e Name 

e Directory Number 

e Location 

e Terminal Number 

* Instrument (telephone) Type 


e Sync Status 


Note: Sorting only affects the displayed list. It does not change the 
actual order of the station records within the database. 


Synchronize Menu 


Use the Synchronize menu to schedule communications with the Meridian 1 
system. The Synchronize menu lets you set up reception or transmission of 
station data using the MAT communications functions. See “Communicating 
with Meridian 1” on page 97. 


Retrieve: Allows selection of station data for retrieval from the Meridian 1 
system into the station database. You can define criteria to select stations for 
download from the Meridian 1 system. Retrieve also allows a Parse Only 
option that formats retrieved data for MAT. 


Transmit: Allows selection of station data for transmission to Meridian 1. 


Reconcile: Compares discrepancies between station data and the MAT 
database and deletes invalid set information from the MAT database. 
Information about deleted sets is recorded in a log file. See “Communications 
Logs" on page 111. 


Note: Before using Reconcile, be sure to Retrieve the latest station data 


first. This ensures the station data is compared to the latest MAT 
database. 
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Forms Menu 


Use the Forms menu to configure form-based station administration. 


Forms Interface: Enable or disable form-based station administration. 


Select Form: Select which form to be used by form-based station 
administration. 


Edit Custom Form: Run the station form editor. 


Options Menu 


Use the Options menu to configure options which affect the operation of the 
Station Administration and CPND Administration modules. 


Mode: Invoke the mode function to configure the operational mode and 
optional station data validations. 
Help Menu 


Use the Help menu to display documentation to help you understand and use 
the application. 


Contents: Displays the Contents page of the on-line documentation system. 


Search Help On: Allows you to type in key words and select a topic of 
interest from the list of Help topics. 


How to Use Help: Provides basic instructions about using the on-line 
documentation system. 


About MAT: Displays copyright and version information about the current 
release of the MAT Station Administration application. 


Accessing Station Data 


Choose View - Station to display the list of stations defined for the system. 
Each line in the list contains the following information for one station. Refer 
to “Managing Station Data” on page 22 for a more complete description of 
these fields. 


Location: A unique station identifier. MAT uses the value here as an index 
to the station. 
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Type: The instrument defined for the station. 


Sync Status: An indication of whether Meridian 1 data and the data in MAT 
are synchronized. The following list defines the synchronization status for 
station data: 


e NEW: A station defined in MAT that has never been uploaded to the 
Meridian 1. 


e  TRN: The station is synchronized with the Meridian 1. 
e CHG: The station has been modified in MAT but not in Meridian 1. 
e RPL: A station defined in MAT to replace synchronized station data. 


e OUT: A synchronized station deleted from MAT but not yet from the 
Meridian 1. 


Prime DN: The prime directory number. 


Terminal Number: The station terminal number, representing the address 
within the Meridian 1 system (Loop # - Shelf  - Card # - Units). 


Last/First Name: The station user's name. 
Department: The department in which the station is used. 


This represents part of the data record for a station so that you can identify 
that station in the listing. The rest of the station data is available as described 
in “Managing Station Data" on page 22. 


The Template View 


Choose View - Template to display a list of station templates defined for the 
system. The list contains the same information for a template as the Station 
view contains for a station. The value of the Location field in the list is the 
actual name of the template as displayed in the template list field of the Add 
Station dialog. 
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The Hardware View 


Choose View - Hardware to display a list of line cards, for station TN 
assignment. If Hardware Validation is active, then the TN added to each set 
will be validated against the TN card type. The cards defined under the 
hardware view are also used for automatic TN assignment. 


The Reserve TN dialog is accessed through the Hardware Configuration 
dialog box. Click on the Reserve Units button. 


New Stations 


You can add new stations to the list in the Station Administration view. Use 
a template that defines data for the station or stations that you are adding, or 
add each station individually. You must give each new station a unique 
Location field value. 


If MAT is in Maintenance mode, you are prompted to schedule 
communication with Meridian 1 whenever you add new stations in MAT. 
You can synchronize the system data now, schedule a time for 
synchronization, or cancel the prompt and schedule synchronization later. 
See “Communicating with Meridian 1” on page 97.) 


Station Template 


Data that is common to many stations can be stored in a template. In a single 
operation, using a template, you can define multiple stations which have data 
in common. The only data that must be added to stations defined with a 
template is the Location field value, so that each station added using the 
template can be identified in the list and by the Station Administration 
module. A template can contain all or part of a station definition and stations 
defined using templates can be changed in the same way as stations defined 
individually. You can change template data in exactly the same way as station 
data. 


Add Stations 


To add new stations, choose Edit - Add from the Station Administration 
window Station view. The Add Station dialog appears. 


Note: The Instrument field and the Template field are mutually 
exclusive. An instrument would be defined in the template. If an 
instrument is selected, there can be no selected template. 
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Figure 3 
Add Station dialog 
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At any time, you can click Cancel to return to the Station list window without 
adding stations. 


When the data for this dialog is complete, click OK to display one of the two 
dialogs below. 


Adding a Single Station 


If you are adding a single station, the dialog for the selected set is displayed. 
You can update the station data now or just give it a unique identifier in the 
Location field and click OK to accept the current data and update later if 
required (see “Managing Station Data" on page 22). 


Adding a Phantom Station 


To add a phantom station, a phantom loop must be defined first. Phantom 
stations can only be added to existing phantom loops. Use Overlay 17 to 
create a phantom loop. Retrieving station data from a system with existing 
phantom stations preserves the phantom loops defined for those phantom 
stations. Phantom loops can only contain phantom stations. 
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Choose View-Hardware from the Station Administration window Station 
view. The Hardware view appears. Choose Edit-Add. The Hardware 
Configuration view appears. Select the phantom card from the drop down list. 
If you do not enter values, MAT enters the next available loop-shelf-card 
information not used by the selected card into the appropriate fields. Click OK 
to return to the Hardware Configuration view. 


Note: Cards must have unique loop-shelf-card combinations. 


Choose View-Station to return to the Station view. Choose Edit-Add. The 
Add Station dialog box appears. In the Instrument field, select an analog type 
set. For example, the 500 set. Click on the Phantom check box. Click OK. The 
Station Data dialog box appears. 


Note: Phantom TNs can only be assigned to analog sets. 


Enter the terminal number for the station in the Terminal Number field. Each 
station must have a unique TN. Double-clicking in Terminal Number field 
displays the Terminal Numbers window listing available terminal numbers 
associated with this loop. If no phantom cards are defined, this window is 
blank. Double-click on an available terminal number on the list to enter that 
value into the Terminal Number field in the Station Data dialog box. 


Adding Multiple Stations 


If you are adding more than one station, the Multiple Station Add dialog is 
displayed. This dialog lets you define some aspects of each station to be 
added. If you used a template for station definition, much of the station data 
may already be defined. 


The dialog contains an updatable list box containing the stations. The 
following data fields allow you to define or update the stations in the list. 


Adding the Stations 


When you have defined the station or stations that you wish to add, click OK 
in the dialog. If the Location field for one or more of the stations is not unique, 
an error box appears. Click OK in the error box to return to the previous dialog 
to make the correction. 
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Figure 4 
Multiple Station Add dialog 
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MAT adds the accepted station or stations to the MAT station database. If 
MAT is in maintenance mode you are prompted, in a Synchronization dialog, 
to set up communication with the Meridian | system. See “Communicating 
with Meridian 1” on page 97. 


Click Cancel in the Synchronization dialog to return to the Station 
Administration list. The new stations are added with a status of NEW. In this 
case, you can use the Synchronize menu at a more convenient time to set up 
communications. 


Deleting Stations 


You can select stations for deletion from the Station list view. Use one of the 
following methods to remove them from the MAT database: 


* Press the Delete key 
e Choose Edit - Delete 
e Choose Edit - Cut 


Each method displays a Yes/ No confirmation prompt before removing the 
stations. If you click Yes, MAT removes the stations from the MAT station 
database. 
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There are special considerations to bear in mind when deleting stations that 
contain references to Voice Mailbox directory numbers. Refer to “Voice 
Mailbox” on page 77 for more information. 


If the stations to be deleted have never been synchronized with Meridian 1 
(Sync status is NEW) they are removed from the list in the window. In this 
case you can bring the stations back by choosing Edit - Undo Delete. This 
undelete is only available until you perform another edit function on the 
station list. 


If the Sync status is not NEW, deleted stations are marked for deletion from 
Meridian 1 at sync time by setting the sync status to OUT. These stations will 
not be deleted from the list until synchronization. If you attempt to change 
such stations, you are prompted to bring them back before the update can be 
performed. If you do bring them back, the status is set to CHG. Attempts to 
delete stations with sync status OUT are ignored. 


Adding a Station Template 


You can use a template of station data to add multiple stations (or a single 
station) with common data. To create a template, choose Edit - Add in the 
Station Administration list view window with the View - Template option 
selected. This displays an Add Template dialog containing a list of 

instruments (telephone types) that you can use with this particular system. 


Figure 5 
Add Template dialog 
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Select an instrument you wish to use for this template and click OK to display 
the dialog for the instrument. You can change the data in this template as if it 
were a regular station (see “Managing Station Data” on page 22). 


You are still reguired to insert a unigue identifier in the Location field before 
the template is accepted. The data entered is used by MAT as the template 
name (displayed in the Add Station dialog). 


If you wish to modify an existing template, proceed as if it were a single 
station. Choose Edit - Update in the Station Administration window with 
View - Template selected. 


Managing Station Data 


MAT displays individual station data in a dialog that graphically represents 
the set used at that station. If the telephone has feature keys, these are 
displayed and can be selected like all other fields. Some data entry fields 
(those that use DN or TN data, for example) can be double-clicked to display 
options for that field. 


Data change is described for a typical set (M2616). Most other instruments 
contain a subset of the data for this instrument, and the update procedure for 
each field and function is the same as that described here. 


Whenever you modify station data that has already been synchronized with 
the switch, the Sync Status for that station is set to CHG. This is an indication 
that MAT and Meridian 1 are not in sync. 


If MAT is in maintenance mode, you are prompted to set up communication 
with the Meridian 1 system. You can synchronize the data at this time, 
schedule a time for synchronization or cancel the prompt and schedule 
synchronization later. See “Communicating with Meridian 1” on page 97. 


Updating Stations 


MAT displays a list of stations for the selected system in the Station 
Administration module when you choose View - Station. You can update the 
data for any station by selecting the desired station and choosing Edit - 
Update. This displays the dialog for the set that the station currently uses. 
You can update multiple stations at one time. See “Global Update” on 

page 83. 
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Station Data 


Typically, the dialog associated with a particular set will contain a subset of 
the data fields and functions listed here for the M2616 set. 


Figure 6 
Station Data dialog 
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In addition to the normal OK, Cancel and Help buttons, the set dialog can 
have other function buttons such as Features and Admin. These functions are 
described in “Features Button" on page 32 and “Administration” on page 35, 
respectively. 


The dialog shown above is for an “M” series digital set. Functions and options 
assignment is described in “Key Assignments" on page 24. An additional 
Key Features Edit field is displayed for analog sets to allow you to assign key 
functions. This field is described in "Key Features" on page 34. 
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For sets that do not have keys or key lamps, the available features are 
displayed within the set dialog itself. The assignment procedure is as 
described in “Key Assignments” on page 24. 


Key Assignments 


In addition to the data fields, the set may have keys to which you can attach 
feature functions. When you select a key, a Key Assignments dialog 
containing a single-selection scrollable list of Key Features is displayed. The 
features listed are defined for this set using the Features button on the station 
data dialog. Refer to “Station Features” lists in the Appendix to this 
document. 


Figure 7 
Key Assignments dialog 
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In addition to the usual OK, Cancel and Help buttons, the dialog has a Clear 
button that you can use to remove any feature attached to the selected key on 
the set (to assign a different feature, it is not necessary to first clear the current 
feature). You may also enter the first letter of the Key Feature of interest to 
move to that section in the list. 


The dialog contains a single-selection Key Features list. The currently 
selected feature is highlighted. Select using the mouse or the up/down arrow 
keys. 
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Click Cancel at any time to return to the station data dialog without changing 
the current key assignment. Click OK to assign the selected feature to the key. 


Some of the features require you to enter additional information. When you 
select one of these, text entry boxes are displayed in the dialog. You can 
double-click on a DN text entry box to display the list of DNs in the 
customer's Numbering Plan that are available to the selected feature (see 
“Directory Number Assignment” on page 25). 


Directory Number Assignment 
There are three kinds of DNs: 


1 ADN assigned to the station. This must be in the customer's Numbering 
Plan as defined for the system. 


2 ADN referred to by this station (message center, for example) that must 
be in this customer's Numbering Plan. 


3 ADN referred to by this station (Call Forward, for example) that can be 
the number for any station—external or within the Numbering Plan. 


To enter a DN for a selected station, you can type the number into the 
Directory Number field or double-click within the Directory Number field to 
select from a list of DNs used in the Numbering Plan for the customer. 


A manually entered number for DN categories | and 2 above will not be 
accepted if it is not contained in the Numbering Plan, unless the Numbering 
Plan validation has been turned off (Option - Mode). 
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Figure 8 
Directory Numbers dialog 
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If you are assigning a DN to this station (versus referring to the DN of another 
station as in forwarding or hunting options) the dialog allows functions in 
addition to the usual Cancel, Help and OK buttons: 
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Assign: assigns the highlighted DN to the key. 


MARP: If the assigned DN is being used by another station you can 
assign incoming calls to that DN to this station with the Multiple 
Appearance Redirection Prime (MARP) button. To assign incoming 
calls to the other station, you must update the other station and select the 
MARP function here. This button toggles the current MARP assignment. 


CPND: A Call Party Name Display (CPND) display dialog allows you to 
define how calls from this station are displayed to the receiving station. 
See *CPND Data Considerations" on page 41. 


VMB: A Voice Mailbox (VMB) display dialog allows data associated 
with a DN (which serves as a mailbox ID) rather than a TN. You can 
modify the VMB data from any station which has an appearance of the 
mailbox DN. Refer to “Voice Mailbox" on page 77. 
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The dialog contains a single-selection list of DNs defined in the numbering 
plan for this system. Those numbers that are already assigned also have 
MARP and Location data listed. The currently selected DN is highlighted. If 
you are assigning a DN to this station, the dialog also contains a display-only 
box with the current DN assignment entered. 


At any time, click Cancel to return to the previous window without changing 
the current assignment. Click OK to assign the DN and return to the previous 
window. 


Terminal Number Assignment 


The Terminal Number (TN) is the full hardware address of the port to which 
this station is attached. If the Terminal Number field requires an entry, you 

can type the number into the Terminal Number field or you can double click 
within the field and select from a list of available TNs. The data entry must 

be in the format: 


lll s cc nn 


Where: 

lll = The number of the Meridian 1 loop. 

S = The number of the system shelf. 

cc = The number of the shelf card position. 
nn - The number of the card circuit (port). 


The range of numbers available depends on the hardware configuration and 
software release in use at the system. 


The list shows the Location for all TNs that are already assigned. See Figure 
9. 
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Figure 9 
Terminal Numbers window 


Terminal Numbers 


Location Reserved Units 
004-0-03-01 Fiber Remote - Building A 
004-0-03-02 Fiber Remote - Building A 
004-0-03-03 Fiber Remote - Building A 
Fiber Remote - Building A 
OOSMLT Fiber Remote - Building A 
2250 Fiber Remote - Building A 
2250 Fiber Remote - Building A 
OOSSLT Fiber Remote - Building B 
Fiber Remote - Building B 
Fiber Remote - Building B 
Fiber Remote - Building B 
Fiber Remote - Building B 
Fiber Remote - Building B 
Fiber Remote - Building B 
Fiber Remote - Building B 

004 0 06 00 Voice 
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The dialog contains a single-selection list of TNs defined in the Station 
Hardware view that permit access to the set defined for this station. The 
current selection is highlighted. 


At any time, click Cancel to return to the previous window (Set dialog) 
without changing the current assignment. Select a TN and click OK to assign 
the TN and return to the set dialog. The MAT system validates the TN for 
availability and permissibility using the Hardware assignments stored under 
the Station Hardware view, and assigns the TN. 


Note: Automatic TN Assignment will not assign any units in the 
Hardware View that are marked as a RUT. See “Reserve TN Feature" on 
page 30. 
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Reserve TN Feature 


This feature allows users to assign TNs to support instrument types on a 
station line card and mark these units as reserved for a given unit type. These 
types, referred to as Reserve Unit Type (RUT) include: 


e ATT (Attendant Console) 

e 1250 (1250 Digital Attendant Console) 

e 2250 ( 2250 Digital Attendant Console) 

e R232 (RS232C Units) 

e R422 (RS422 Units) 

e  OOSSLT (Out of Service Single Line Terminal) 

e OOSMLT (Out of Service Multiple Line Terminal) 
e PWR (Power for Attendant Console) 

e OTHER (as defined by the user) 


When a unit is reserved as one of these types, it will not be assigned during 
Automatic TN Assignment and will appear in the TN Selection List Box 
accordingly. The Automatic TN Assignment will not assign any units in the 
Hardware View that are marked as a RUT. RUTS are validated at the field and 
global levels. RUTs are marked by the user in the Hardware View and by the 
Station Retrieval Module. The Reserve TN feature shows existing Usage 
Fields at the card level in the Hardware view. 


Note: Reserved Units TNs are skipped during Automatic Terminal 
Assignment. 
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Access the Reserve Units dialog box through the Reserve Units button in the 
Hardware Configuration dialog box. See Figure 10. 


Figure 10 
The Reserved Units button in the Hardware Configuration window 
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Usage 


Analog Line Card 





The Station Retrieval Module recognizes RUTs and updates the Reserved 
Units fields in the Hardware View with the RUT value during an initial 
retrieval. Discrepancies are handled in the same way as other retrieved fields 
with the Meridian 1 value overwriting the MAT database value. RUTs are not 
displayed in the Retrieval Specify by Type field since they are not treated as 
Station Types. 
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Use the Reserve Units dialog box to assign RUTs. See Figure 11. 


Figure 11 
Assigning values in the Reserved Units dialog box 
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Features Button 


The Features button on the station data dialog lets you examine and update 
station features and options defined for your system. The Features button 
displays a list box containing a single-selection scrollable list of features or 
feature groups. See Figure 12. 


You can choose to sort by either Features or Feature Groups by choosing the 
appropriate radio button. “Features” sorts the features alphabetically by 
Meridian 1 mnemonic. “Feature Groups” organizes the features into related 
categories. 
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Figure 12 
Features dialog 


TH Haak Alors Sou 
Weis Link Urt ee Ba 


tucson ande 3 
Bul hear gens cole d 
hul heerser c 5 
Autharcauen coda b 
5i ed kaat Sfear For. uber dea 





The dialog contains Select, Done and Help function buttons. Help displays 
on-line help for this dialog. Done returns to the station data dialog and Select 
displays a dialog associated with the selected feature that lets you define 
appropriate parameters for that feature, and perhaps assign the feature to a 
key. 


You can examine and modify any number of features in one session by 
selecting another feature each time you return to this dialog from the Feature 
dialog. You can modify features until you have completely defined the 
features for this station. 


When you are finished defining or examining features, choose Done to return 
to the station data dialog. If you have assigned keys, the appropriate keys are 
labeled in the station data dialog. 


Feature Group category 

When you select Search by Feature Group and choose Select in the 
Features dialog, a dialog that defines the selected feature appears. The dialog 
shown in Figure 13 is for the Call Pickup feature. The other dialogs are 
similar in appearance. 
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Figure 13 
Feature dialog (example) 
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The dialog contains fields (usually text boxes associated with drop-down 
selection lists) that define the functionality of the feature. If the feature can be 
assigned to a key, the dialog also contains a Key Features list of functions that 
can be assigned to a key for this feature. 


Forced targets 

Some entries in the Feature dialog box will force a change in the class of 
service (CLS) of the selected station. For example, filling in the “Flexible 
Call Forward No Answer DN (FDN)” field of call redirection forces “Call 
Forward No Answer (FNA) to "Allowed". This target enforcement occurs 
only as the feature dialog is exited. There may be a noticeable flickering of 
the screen as the values are forced and the dialog exits. 


Key Features 

The Key Features field is a single-selection list of features associated with 
this feature group. You can assign the function selected in this list to a key for 
the selected station. 


You assign features to a key from the Key Assignments dialog. Double click 
the desired function in the Key Features list of the Features dialog to display 
the Key Features Edit dialog for the selected function. 


Note: Youcan only make key assignments to sets with feature keys. Key 
assignments cannot be made to Type 500 or 2500 stations. 


The dialog shows a single-selection list of key numbers. Each key in the list 
shows any already-assigned feature (and associated DN if applicable). The 
list is dimmed except for any assignment made during this session. 


PO876405 Standard July 1998 


Station Administration Page 35 of 194 


Figure 14 
Key Features Edit dialog 





The list field is associated with two function keys, Set and Clear. If the 
selected key is already assigned, the Set function is dimmed. Use the Clear 
function to remove a key assignment. Use the Set function to assign the 
current feature to an unassigned key. 


At any time, click Cancel to return to the Features definition dialog without 
changing the current key assignments. Click OK to assign key function and 
return to the Features Definition dialog. 


Administration 


Choose Admin in the station data dialog to display the Administration dialog. 
The Administration dialog allows you to assign values to fields that MAT 
uses in classifying and administering station data. These fields are not part of 
the Meridian 1 data block. The user fields and their labels are assigned using 
Edit - User Field Names. These headings allow you to define values for your 
own situation. This option contains text boxes so that you can assign specific 
values to these fields for this station. 


The data entry fields in this dialog include: 


Category: A drop-down list of line connection types for this station 


Station Administration User Guide 


Page 36 of 194 Station Administration 


Figure 15 
Administration dialog 



















































































r- User Fields r- Admin Fields 
Cable # Employee # Equipment Cost Division 
Assett # User Field & Cost ID Billing Auth Code 
Soc Sec # User Field 7 
Data I.P. User Field 8 
Auto License User Field 9 

Category Color Pwr Fail TN LDN Index 
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Comment | 
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Color: A drop-down list of colors available for this instrument. 
Pwr Fail TN: A text box for the TN used if the system power fails. 


LDN Index: Radio buttons to define which of three indexes contains the DN 
for this station. A DN index is set up at the system level when the Numbering 
Plan is defined. The index is used while viewing and printing designation 
strips for this instrument. 


Admin Fields: The Admin fields are used by the Call Accounting Billing 
Database for billing purposes and other types of cost allocation. Refer to the 
MAT Call Accounting User Guide Database menu section for details. 


Designation Strips 


A telephone can have many features and services available by function 
buttons (keys) and indicators. A Designation Strip is a printout of labels that 
can be attached to the telephone to indicate the function of the various buttons 
and indicators on the set (and also the DN of the station using the set). You 
can create files that let you examine and print Designation Strips created from 
the data defining the stations using File - Desig. Strip. 
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A Designation Strip will typically contain the directory number for a single 
line set. In addition, sets with key caps that designate a DN (for multi-line 
sets) or reference other DNs also appear in the Strip. 


Designating Directory Numbers 


A Meridian 1 system can have up to three listed directory numbers (LDN). 
The system Numbering Plan defines whether ranges of directory numbers 
(DN) are set for direct inward dialed (DID) or not. Typically, a station DN, as 
defined for the Designation Strip, is a regular 10 digit telephone number with 
an extension: 


(aaa) xxx-aaaa Ext bbbb 


Where: 

aaa represents the area code 
XXX represents the exchange 
aaaa represents the number 
bbbb represents the extension 


The Designation Strip utility examines the System Configuration Customer 
data to determine the LDN used by the station. The utility determines whether 
the station DN is in a DID range defined in the system Numbering Plan. The 
following are the two possible results: 


Non-DID number: The Strip prints the LDN and uses the station DN for the 
extension. 


DID Number: The Strip gets the area code (aaa) from the LDN, the exchange 
(xxx) from the DID number, the number (aaaa) from the station DN. 


Display of Designation Strips 


Choose File - Desig. Strips from the Station list window to display the Strip 
Selection dialog. See Figure 16. 
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Figure 16 
Strip Selection dialog 
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The dialog contains a single-selection scrollable list of Designation Strip 
types created by MAT. The current selection is highlighted. Cancel returns 
to the Station list window. Help displays on-line help for the dialog box. Test 
Pattern sends a single page dummy strip to the Viewer. Use this to print on 
the appropriate form and ensure that the form is aligned correctly in the 
printer. Strip sends Strips for stations selected in the Station Configuration 
view to the MAT Viewer. From the Viewer window, print the strip by 
selecting File - Print from the menu bar. 


Designation Strips are printed on special forms. The following separate form 
layouts are used by MAT: 


e Unity for Unity 1 and Unity 2 sets 

e Unity 3 for Unity 3 sets 

e Compact for older SL-1 type sets 

e  SL-1/500 for normal SL-1 type sets 

e Digital for M2000 series digital sets (not M3000 series). 


Note: All other sets would use the SL-1/500 Strip layout. Stations with 
ACD keys will have both the ACD DN and the Position ID printed. It 
would be up to the user to attach the desired label to the appropriate key. 
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Station Data Validation 


The station database contains one record per station. Some of the field values 
in a record depend on the system properties, the instrument used, and features 
and options enabled. In addition, the MAT application contains “rules” that 
define possible values, sizes, and ranges for the fields. 


The Station Administration module includes a Validation utility that checks 
that the values assigned to certain fields are compatible with the configuration 
and the MAT data rules. 


The Validation function checks the currently selected station records in the 
Station list view before uploading to the Meridian 1. There are two 
options— partial and full validation. Full validation checks every field and 
might require considerable time. 


Note: You can validate the data for each station individually using the 
Validate function key on the set dialog. This button examines the entries 
for the current open station only. Any errors are noted. Perform a Station 
Validation to capture any data entry issues that may result in a 
transmission error when synchronizing with the Meridian 1. 


Validating the Data 


Select the stations for validation in the Station list view and choose File - 
Validate to display a cascading submenu. Choose Partial (checks the values 
defined previously) or Full (checks all field values) to start the Validation 
check. 


While MAT performs the checks, a status box indicates progress in single 
record increments. At any time, click Cancel in the status box to halt the task. 


Note: Clicking Cancel discards the validations already completed. 


When the task is complete, the MAT Viewer displays the validation data. You 
can save this to a text file (in a user-defined file name and location), print it, 
or simply browse and discard it (see Generating Reports" on page 121 for a 
description of the Viewer). 
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When the task is complete, you should send all the new or modified station 
and CPND information to the Meridian 1 system. You may select all the NEW 
or CHG stations, for example. You should apply the Validation process from 
the File menu to the selected stations to ensure that the entered data is 
consistent across all stations. See “Communicating with Meridian 1” on 
page 97. 
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CPND 


CPND Overview 


Call Party Name Display (CPND) displays the name of the calling party of an 
incoming call to the called station user. The CPND data is associated with a 
DN, and not with any particular station. If CPND data is assigned to a DN, it 
may be associated with multiple stations. 


The CPND Administration module is separate from the Station 
Administration module. CPND Administration lets you create, maintain, 
change, and report on single and multi-line CPND information. CPND 
Administration data defines the setup for each customer's CPND 
configuration and CPND Name data defines the display parameters for DNs 
used by a particular customer. Station configuration data and CPND data are 
separate within Meridian 1 and are treated as separate files within MAT. 


CPND data for a station is accessible through the Station Administration 
module. The CPND button in the DN list of the Station module allows you to 
maintain CPND information directly from the DN list. This is particularly 
convenient if several DNs are to be linked back to the name for this station. 


CPND is provided as a separate module to allow you to directly enter CPND 
data for DNs, Dial Intercom Groups, or DNIS IDC. The display of MAT 
CPND records shows the synchronization status and can be used to 
selectively synchronize this data with the Meridian 1 system. 


CPND Data Considerations 


You should be aware of the following considerations when using the CPND 
Administration function of Station Administration. 
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CPND Names vs. Station Names 


The name defined for CPND need not necessarily be the same as that defined 
for a station end user on the face of the station graphic. The Station 
Configuration Name is only maintained in MAT and is not stored in the 
Meridian 1. The name stored by MAT is the CPND associated with a 
particular DN. 


In most cases, the name on the station graphic is also the name associated with 
a DN of the station. MAT can automatically link the name on the graphic with 
one or more of the DNs on the station. To link the name on the graphic with 
a DN, fill in the location code of the set in the “get name from location" field 
on the Name dialog. 


The Station Retrieve module automatically parses and updates the Merdian 1 
CPND Name information. The module automatically sets the value for the 
“get name from location” field in the CPND Name dialog box to match 
changes in the Referenced Location values. Changes to the name on the 
station will not affect the station’s Sync Status but will update any CPND 
name entry to RPL. 


If the name data is linked in this manner, the first and last names in the name 
dialog will be filled in and grayed. The data can only be changed from the 
station graphic. In order to remove the linkage, delete the location code from 
the “get name from location” field in the Name dialog. 


The CPND Name information is accessed in either the Station module (from 
a CPND function button in the DN list dialog) or the CPND module. All 
CPND data is synchronized with the Meridian 1 system using Overlay 95 
(and not with the CPND prompt in Overlays 10 or 11 as in recent versions, 
Release 19, of the Meridian 1 system). 


CPND Synchronization 


CPND and Station synchronization are separate functions. They are only 
connected if CPND data is defined from the Station DN list, or if the CPND 
name is taken from the Name field of the Station Administration module. 


In some cases, MAT is aware of such a connection. If MAT is in Maintenance 
mode, the system automatically attempts to synchronize the new CPND 
information when the station is transmitted. In installation mode, you must 
synchronize CPND data separately from within the CPND module. 
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The CPND Module 


The MAT CPND Administration module allows access to the CPND data for 
a single Meridian 1 system. When you open the CPND module, a list of name 
data contained within MAT is displayed. If the data has not yet been retrieved 
from the Meridian 1 or added to the MAT database, the window contains no 
data. 


Figure 17 shows the MAT CPND Administration window as first displayed. 


Figure 17 
CPND Administration window 
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Accessing CPND Data 


The MAT CPND Administration window allows you to configure CPND 
blocks. After CPND blocks are configured, you can configure Name data for 
DNs. 


From the View menu, the following list views for CPND data are available: 
e Customer Configuration list (CPND Administration). 
e Name display list (CPND Name) 
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The CPND list view contains only a few items (just one in many cases). This 
view lists the CPND blocks configured on this system. The Name view might 
have many items, probably more than will fit in the current window. This is 
the scrollable list of names whose display parameters are defined for CPND. 


CPND Administration View 


With View - CPND selected, the CPND Administration window displays the 
list of CPND blocks configured for the system. The following information is 
displayed for each customer: 


e Customer: The customer number as defined in the system configuration. 


e Sync Status: The synchronization status of the station’s data between the 
Meridian 1 and MAT. See CPND Name view for more detail. 


The data in the window is part of the CPND Administration data stored in 
MAT. The complete configuration data for this system is available as 
described in the CPND Data Change section of this document. 


CPND Name View 


With View - CPND Name selected, the CPND Administration window shows 
a list of names defined in the system. The following headings define the data 
for each station displayed: 


¢ Customer: The customer number that uses this DN. 


e — Sync Status: The synchronization status of the station’s data between the 
Meridian | and MAT. 


e Number: The DN using the CPND data. 


* Name: The defined CPND name (not the name of a station user unless 
called for in the Location field). 


e Location: The optional unique station Location Code for the CPND 
name source. 
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Sync Status: An indication of whether Meridian 1 data and the data in MAT 
are synchronized. The following list defines the status for CPND data: 


e NEW: CPND data defined in MAT that has never been uploaded to the 
Meridian 1. 


e TRN: The CPND data is synchronized with Meridian 1. 


e CHG: Data has been changed in MAT but the change has not been sent 
to the Meridian 1. 


e — RPL: Data defined in MAT to replace synchronized name data. 


e OUT: Synchronized CPND data deleted from MAT but not yet removed 
from the Meridian 1. 


The data in the window is part of the name display data stored in MAT. The 
complete name data is available as described in CPND Data Change. 


CPND records can be sorted and displayed a number of ways. In the CPND 

Administration window, select View-Sort-.... Records can be sorted by: 

e Directory Name 

e Last Name 

e First Name 

e Sync Status 
Note: When upgrading from a previous release of MAT to MAT 6, any 
CPND name that is linked by location to a station will not sort by first 
name and last name since names linked to stations in this way are not 
stored in the CPND database. Perform a station retrieval to resolve this 
discrepancy. 

Recommended Usage 


You cannot build CPND Name data until the CPND data block is defined. 
First you must configure (or retrieve from Meridian 1) the CPND data block 
for the selected customer. 


When the customer's CPND data block is defined, you can create (or retrieve 
from Meridian 1) the CPND Name display information. 
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CPND Data Change 


You can change the data associated with the selected CPND view. The 
selected item in the list view is highlighted. Select an item using a mouse click 
or use the up/down arrow keys to highlight the desired item. You can also 
double-click the desired item. 


Choose Edit - Delete to remove the selected CPND list item. Choose Edit - 
Update or Edit - Add to display a dialog that allows you to update the data 
fields for the selected view. 


Updating the Customer Configuration Data 


With View - CPND selected, you can change the selected customer's CPND 
data. The selected CPND block is highlighted in the customer list window. 


Choose Edit - Update to display the Call Party Name Display dialog: 


Figure 18 
Call Party Name Display dialog 
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Updating the Name Display Data 


Choose Edit - Update in the CPND Name view window (or double-click the 


item in the list) to display the CPND Name dialog for the selected station 
name. See Figure 19. 


Figure 19 
CPND Name dialog 
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Overview 


The enhanced Corporate Directory feature introduces added capabilities to 
view, manage, and generate reports using available station information from 
systems configured with at least one user. To use this feature, you will need 
the Station Administration application installed and configured correctly as 
well as Microsoft® Excel 95® or later. 


Using Corporate Directory 


The enhanced Corporate Directory feature uses a graphical user interface 
(GUI). Use the convenient menu selections, toolbars, and windows to 
complete your tasks. 


Accessing Corporate Directory 


Be sure to have MAT 6 or higher with the Station Administration application 
installed and configured correctly. Start MAT and from the Navigator 
window, select Utilities-Corporate Directory. See Figure 20. 
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Figure 20 
Accessing Corporate Directory 
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Corporate Directory Window 


The Corporate Directory main window presents a graphical way to work with 
station information. Use this window’s commands from the drop down 
menus or the toolbar to view, manage and generate your reports. You will see 
a list of predefined report formats the first time the main Corporate Directory 
window is launched. See Figure 21. 


Figure 21 
Corporate Directory main window 
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Automatic Call Distribution Predefined 2 Systems 6 Fields 09/20/97 15:03:38 

Telephone Directory Predefined 4 Systems 4 Fields 09/20/97 16:33:02 
" Predefined 4 Systems 6 Fields 03/01/97 8:00:00 

List of Used DNs Predefined 1 Systems 5 Fields 09/20/97 15:03:38 


Ready 





Each report format has the following attributes, as noted by the column 
headers. 


e Report Name - names of available reports 
e Type - notes if the report is either predefined or customized 


e Number of systems - number of systems for which the report will be 
generated 


* Number of Data Fields - number of data fields in the report 


e Last Generated - date and time when the report was last generated 


Note: Double-clicking on a report name displays that report's property 
sheet. See “Report properties" on page 62. 
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Working with the Corporate Directory window 


Use this window’s commands from the drop down menus or the toolbar to 
view, manage and generate your reports. 


Menu selections 


Commands in Corporate Directory are available from the pull down menus. 
The tables below describe the available commands. 


Table 1 
File menu selections 


Selection Description 


Generate Report/ Shows a dialog box where the user selects a display 

Now method for the report. A report may be displayed on 
screen in a spreadsheet, printed to a default printer, 
or saved to a text file. 


Generate Report/ Shows a dialog box where the user selects a report 
Schedule destination and a specific date and time and other 
scheduling properties for the report. 


Generate Report/ Opens a previously generated and saved report for 

Open the selected item and displays it in a spreadsheet 
format. If no such report is available, a message box 
appears asking the user to verify the path and file 
name of the export file or regenerate the report. 


Properties Opens the property sheet for the selected report and 
allows the user to configure the report. 


Close Saves the window’s current settings and exits the 
application. 
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Table 2 
Edit menu selections 


Selection Description 


Undelete Directory Recovers the last deleted user-customized report. 


Delete Directory Removes the selected user-customized report. 
Predefined reports cannot be deleted. 





Table 3 
View menu selections 


Selection Description 


Toolbar Displays or hides the tool bar. The menu shows a 
checkmark next to the item when the toolbar is 
displayed. 


Status Bar Displays or hides the status bar. The menu shows a 
checkmark next to the item when the status bar is 
displayed. 


Filter Toolbar Displays or hides the filter bar. The menu shows a 
checkmark next to the item when the filter bar is 
displayed. 





Table 4 
Configuration menu selections 


Selection Description 


Add Report Displays a new report property sheet. Use this to 
create a customized report. 


Column Name Displays a dialog box where the user defines 
column names for data fields. 
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Table 5 
Help menu selections 


Selection Description 


Help Topics Displays the index of help topics. 


What's This Provides context-sensitive help on the next item 


you select. Clicking anywhere else takes you to the 
first topic in the help topic list. 


About Corporate Displays information about the application. 
Directory 





Toolbar 


The toolbar provides another way of executing menu commands. Common 
tasks are available from the tool bar. See Figure 22. 


Figure 22 
Corporate Directory tool bar 
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The following table describes the function of each button. 


Table 6 
Toolbar buttons (Part 1 of 2) 


Button Description 


Add Report 


Open Report 


Generate Report 














Schedule Report 





Delete Report 


Undelete Report 
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Table 6 
Toolbar buttons (Part 2 of 2) 


Properties: Displays information about the 
application 


Help Topics: Displays the index of help topics 


Context Help: Provides context-sensitive help on 
the next item you select. Clicking anywhere else 
takes you to the first topic in the help topic list. 





Filter Bar 
Use the filter bar to show reports in the Corporate Directory window, based 
on their type. The default setting displays all reports. See Figure 23. 


Figure 23 
Filter tool bar 


Show: [ Allreports [v Predefined — [ Customized 





The available settings are: 


e All Reports: displays all reports, predefined and customized 
e Predefined: displays only the predefined reports 


e Customized: displays only the customized reports 
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Pop-up menus 

Pop-up menus show the available commands for a selection. Pop-up menus 
are activated by clicking the right-mouse button while the cursor is in the 
report list portion of the Corporate Directory window. Unavailable 
commands are dimmed. Menu items from the pop-up menu behave 
identically to the menu items in the pull down menus. See Figure 24. 


Figure 24 
Pop-up menu 
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Generating Reports 


The Corporate Directory feature lets you view, manage, and generate reports 
using available station information from systems configured with at least one 
user. Reports can be viewed on screen, printed, or saved to a file. Report 
layout and formatting is done through Microsoft Excel. See figure 25 for an 
example of a typical report format. 


Figure 25 
Typical report format 


X Microsoft Excel - Telephone Directory (phone book). ls 


[53 File Edit View Insert Format Tools Data Window Help 
[Dc &elàt BRS o-c- ww r5 zi da 416-3) 


|| Aria -0--BZU/zzasEB so, N MEE  -95-A- 














LastName First Name Prime DN Department 

Tang Adrian 4000 President Mission Park\Option 51C 
Pontius Ben 4100 Sales Mission Park\Option 51C 
Fong Sharon 4101 Cafeteria Mission Park\Option 51C 
Lei Jonathan 4102 Technology Mission Park\Option 51C 
Huboi Peter 4103 Manufacturing Mission Park\Option 51C 
Rees Rick 4104 Accounting Mission Park\Option 51C 
Lee James 4110 Manufacturing Mission Park\Option 51C 
Borel Mel 4111 Product Management Mission Park\Option 51C 
Ko John 4112 Transportation Mission Park\Option 51C 
Cobb Tim 4115 Accounting Mission Park\Option 51C 
Walker Jon 4115 Customer Service Mission Park\Option 51C 
Lager Derek 4162 Diner Mission Park\Option 51C 
Wang Larry 4162 Cafeteria Mission Park\Option 51C 


4171 Mfg support Mission Park\Option 51C 
/ I | >| 


=z) [ ae | 
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You can either generate a report immediately or with a defined schedule with 
specific dates, times, and intervals. Generated reports use the data extracted 
from the MAT database. These reports are automatically saved with a system 
default name to the default location unless you specify another name or 
location. A total of ten reports can be automatically saved in this manner. 
Subsequent saved reports overwrite the earliest ones saved as the system 
recycles through its default names. 


Generate reports now 


To generate a report immediately, select the report name from the window 
and click on the Generate Report Now tool bar button. This displays the 
Generate Report dialog box. Select one of the three destination options. Click 
OK to start the report generation process or Cancel to abort the process. See 
Figure 26. 


Figure 26 
Generate Report Now dialog box 
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Generate report and send to printer 


Generate report only 











Cancel | Help | 
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Table 7 
Generate Report Now dialog box controls 


Control Description 


Generate report and Generates a new report and displays it in MS Excel. 
display in MS Excel 


Note: You must have MS Excel installed and configured to 
use this option. 


Generate report and Generates a new report and sends it to a specified 
send to printer printer 


Generate report only Generates a report and saves it to disk. 


OK Starts the report generation process and closes the 
window 


Cancel Exits the dialog box without generating a report 


Help Displays the online help topic associated with this 
dialog box. 





Generate reports by schedule 


Select the report name from the window and click on the Schedule Report tool 
bar button. This displays the Schedule Report Generation dialog box. Use this 
dialog box to select one of two destination options. See Figure 27. 


Click Schedule... button in this window to show the Scheduling window. Use 
this window to specify when and how often to generate the report. See Figure 
28. 
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Figure 27 
Generate Report Schedule dialog box 





Figure 28 
Scheduling window 
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Report properties 
Each report shows a specific set of station data. Corporate Directory provides 
a set of reports whose properties are already defined. See “Predefined 
reports” on page 68. You can create customized reports for your specific 
needs. See “Customized reports” on page 69. 


View report properties by double-clicking or clicking the right-mouse button 
and selecting Properties on an available report in the Corporate Directory 
window. This presents a property sheet with three tabs titled General, Data 
Fields, and Output. The property sheet contains information specific to the 
selected report. 


There are four buttons common to each property sheet: 


e OK - saves any changes and exits the property sheet 
e Cancel - exits the property sheet without saving any changes 
e Apply - saves the changes without exiting the property sheet 


e Help - displays help topics for the property sheet 


General tab 

Use the General tab to view or define a report name. Additionally, use the 
General tab to specify multiple sites and systems for which the report will be 
generated. All available sites and systems are listed. Click on the check box 
next to an entry to include it in the report. Click on a marked check box to 
deselect it and exclude it from the report. Reports are generated with data 
from all included sites and systems. See Figure 29. 


Controls in the General tab include: 


e Report Name - displays the report name. New report names are entered 
here. Users are limited to report names of up to 100 characters. 


e Save As - saves the current report as a new customized report. The “type” 
notation automatically changes from “PREDEFINED” to 
"CUSTOMIZED" as needed. 


Note: The new report name must be unique. Otherwise, the Save As 
command fails. 
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Figure 29 
General tab in the Report Properties sheet 
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* Directory Members 


—  Sites/System/Customer - displays available sites and system names. 
Check boxes indicate if the site or system is included in the report 


— Include All - selects all sites and systems; all boxes are checked 


— Exclude All - deselects all sites and systems; all boxes are 
unchecked 


— Show Selected Only check box - toggles the list to display selected 
items only or all items 
* Comments - accepts user comments up to 256 characters for customized 
reports only 
e Last Updated - displays when the last change was made to the report 
e Last Generated - displays when the report was last generated; this field is 


empty if the report has never been generated 


Data Fields tab 

Use the Data Fields tab to configure the report's data fields and column 
names. Supported station data fields are displayed. See "Supported Data 
Fields" on page 70. 


Click on the check box to include that particular field in the report. For each 


data field, you can specify a column name; otherwise the report uses the 
default mnemonic. See Figure 30. 
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Figure 30 
Data Fields tab in the Report Properties sheet 
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Controls in the Data Fields tab include: 


Data Fields - lists all the available station data fields at the corporate 
level. Use the check box to select or deselect a data field. 


Include All - selects all data fields; all boxes are checked 
Exclude All - deselects all data fields; all boxes are unchecked 


Show Selected Only - toggles the list to display selected items only or all 
items 


Edit - displays a dialog box to edit the column names for the data fields 


Output tab 
Use the Output tab to define the report’s output format and export destination 
for the results. See Figure 31. 


The Output page displays the order the columns appear in the report (left to 
right). Additionally, it displays the file and path name to be used when the 
report is generated and saved to a file. Type the path and filename or use 
Browse to navigate the directory structure to find the desired file. 


Controls in the Output tab include: 


P0876405 Standard 


Move Up - moves the selected column name up the list by one position 


Move Down - moves the selected column name down the list by one 
position 


File Name - allows the user to enter the path and file name for the export 
file 


Browse - allows the user to navigate the directory structure to search for 
a path and file name 
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Figure 31 
Output tab in the Report Properties sheet 
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Predefined reports 


Corporate Directory includes four commonly generated reports as predefined 
reports. These are listed below along with their data fields and column names. 


e Automatic Call Distribution Stations report 
— ACS - Position IDT 
— CLS - Trunk/Call Type Access Restriction 
— SPID - Supervisor Position ID 
— LOC - Location 
— TN- Terminal Name 


— LNAME - Last Name 


e Telephone Directory report 
— LNAME - Last Name 
— FNAME -First Name 
— PRIMEDN - Directory Number 
— DEPT - Department 


e Directory of Prime DNs report 
— PRIMEDN - Directory Number 
— INST - Intrument Type 
— TN -Terminal Number 
— LOC - Location 
— LNAME - Last Name 
— FNAME -First Name 
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e Listing of Used DNs report 


PRIMEDN - Directory Number 
LNAME - Last Name 

FNAME -First Name 

LOC - Location 

TN - Terminal Number 


Customized reports 


Use Corporate Directory to create new report formats for your specific 
reporting needs. On the Report Properties dialog box, select the data fields for 
the sites and systems. 


You can create a customized report by starting with an existing report format. 
Use the Report Properties dialog box to revise the existing report. Be sure to 
save the customized report with a new name. 


Click Add Report to create a new report. This command displays a blank 
Report Properties dialog box with all options set to “off” by default. The 
Report Name field is mandatory. The screen presents an error message if this 
field is left empty when you click OK or Apply. 


Station Administration User Guide 


Page 70 of 194 Corporate Directory 


Supported Data Fields 


The table below lists the acronym and data fields supported by Corporate 
Directory. 


Table 8 
Supported Data Fields (Part 1 of 6) 


CAT Category 
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Table 8 
Supported Data Fields (Part 2 of 6) 


ACDS Key Assigned to Automatic Call 
Distribution (ACD) 


ADN All Directory Numbers 
EHTK External Hunt DN 
EFDK External Forward DN 


AAA Automatic Answer Back 


AEFD Alternate External Flexible Call 
Forward 
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Table 8 
Supported Data Fields (Part 3 of 6) 


EFD CFNA DN for External Calls with 
CFTA 
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Table 8 
Supported Data Fields (Part 4 of 6) 


HUNT Hunt DN - All Calls, or Internal Calls 
Forward 


Machine 
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Table 8 
Supported Data Fields (Part 5 of 6) 
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Table 8 
Supported Data Fields (Part 6 of 6) 
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Voice Mailbox 


Overview 


Voice Mailbox (VMB) data is similar to CPND in that it exists as a separate 
entity within MAT. However, it is associated with a Directory Number 
(which serves as a mailbox ID), and modifications to the VMB data can be 
made from any station which has an appearance of the mailbox DN. The 
station provides a means of access to data which is not a part of the station 
itself. 


Voice mailbox differs from CPND in that it does not have a dedicated 
overlay. CPND information can be modified using overlay 95 as well as 
overlays 10 and 11 (MAT uses overlay 95). Voice mailbox information is 
only accessible from overlays 10 and 11. 


VMB Data Considerations 


VMB data is accessible from the Station Administration module (DN list 
dialog). VMB data is retrieved and transmitted with station data. There is no 
separate VMB communications task as there is for CPND. 


When you delete a station which has one or more single appearance DNs with 
associated mailboxes, you are prompted to delete the mailbox(es) on the 
Meridian Mail system. This information is used to respond to a VMB prompt 
when the station is OUT’ ed on the system. 


VMB data can be modified at the Meridian 1 system through the Meridian 
Mail interface. MAT synchronization is a two step process, as follows: 


1 The Meridian 1 database must be synchronized by uploading the 
information from Meridian Mail using overlay 48. 


2 A station retrieval synchronizes the MAT database with the Meridian 1. 
See “Communicating with Meridian 1” on page 97. 
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Administering VMB 


VMB data administration in MAT is provided within Station Administration 
from the DN assignment function. 


Adding/Changing Stations 


When adding or changing stations, you can access VMB data by choosing the 
VMB button from the DN assignment dialog, similar to CPND. There is no 
VMB button in this dialog for systems without feature package 246. There is 
also no VMB button for multi-line stations when the key is not SCR, SCN, 
MCR, or MCN. Clicking the VMB button brings up the Voice Mailbox data 
entry dialog. 


Figure 32 
VMB data entry dialog 
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The title bar of this dialog shows the DN associated with the mailbox. If it is 
an existing mailbox, the data fields contain information from that mailbox 
record, including the following: 


Synch Status: This is the synch status of the VMB record, which might be 
different from the synch status of the station. 


Class of Service: Numeric entry field (0-127). This field is reguired when 
the mailbox is in NEW status, and there is no default value. 


Second DN: DN entry field. Double clicking the box displays the DN list 
dialog. 


Third DN: DN entry field. Double clicking the box displays the DN list 
dialog. 
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Keep Messages: Drop-down listbox containing YES and NO (NO is default). 
This field is only available when the VMB synch status is NEW. 


The VMB synch status indicates which operation is required at the VMB 
prompt in overlay 10 or 11. 


e NEW: VMB does not exist on Meridian 1 and will be added at upload 
time. 


e CHG: VMB exists on Meridian 1 and will be changed. 
e OUT: VMB exists on Meridian 1 and will be removed. 


e  TRN: VMB exists on Meridian 1 and no update is required. 


Use the Remove button to change the VMB synch status to OUT. This 
operation is confirmed with a message box. When a VMB is in OUT status, 
no further updates are allowed (except for UNDO). 


If a VMB is modified or added from an existing station, that station's synch 
status becomes CHG in order to allow the VMB update to occur as part of a 
station update. 


Deleting Stations 


When you remove a station that has a single appearance DN with an 
associated mailbox, you are prompted to determine if the mailbox should be 
deleted on Meridian Mail as well. In order to respond to this prompt, MAT 
also prompts you for this information when you delete stations. However, to 
avoid possible synchronization problems, a different method is used. 


When you delete stations in MAT, the delete confirmation dialog is 
displayed. On systems with VMB, this dialog contains a Delete VMB 
checkbox that defaults to checked (YES). 


Your YES or NO response is used to continue or cancel the deletion. The 
delete VMB information is stored as part of the delete transaction, so that it 
applies to all affected stations. MAT uses this information to respond to any 
DELETE, VMB prompts presented during transmission of the deleted 
stations. 
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The implications of this approach are as follows: 


e You are prompted for this information even if none of the stations being 
deleted has a single appearance DN. In this case, the information is never 
used. 


e Ifyou wish to delete two stations but give different responses to 
DELETE_VMB for those stations, two separate Edit - Delete operations 
are required. 


This guarantees that the correct information is stored in the station that will 
actually get the DELETE_VMB prompt. In cases where all occurrences of a 
multiple appearance DN are deleted within the MAT database, only the last 
station transmitted will receive the DELETE_VMB prompt. Since it is not 
possible to know which station will be transmitted last in all situations, the 
DELETE VMB information must be stored with all the stations. 


This procedure prevents accidental deletion of mailboxes when the MAT and 
Meridian 1 databases are not completely synchronized. Since MAT prompts 
you on any deletion (even if no single appearance DN’s are involved), the 
DELETE_VMB information is available if the Meridian 1 prompts for it 
unexpectedly. For example: The MAT database has two appearances of a DN, 
but the Meridian 1 database has only one (due to a change done in overlay 10 
or 11). 


Changing DNs 
When you change a DN on a station, its associated mailbox must be removed 
from the VMB file if the DN prior to the change was single appearance. You 
should delete the VMB record when you commit to the station update by 
clicking OK on the Station dialog. In order to warn you when a mailbox 
record is to be deleted, a confirmation dialog appears. 


The confirmation dialog appears when a station change will result in one or 
more mailboxes being deleted. If you choose to cancel at this point, the entire 
station update is canceled. If you choose to continue with the operation, the 
mailbox can be restored later by performing an undo of the station update. 


Because a single mailbox can be updated from multiple stations and those 
stations can be transmitted to the Meridian | system in any order, there are 
some synchronization issues which can not be resolved by MAT. Some of 
these issues are described in the examples below. 
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All of the following examples involve two transactions, which, by default, are 
transmitted on a first-come-first-served basis. The ambiguities described 
below only occur if you schedule the second transaction to be transmitted 
before the first. 


VMB Data Synchronization 


Consider the following examples when scheduling synchronizing station data 
associated with Voice Mailbox data: 


Example 1—Deleting Stations 


Station A and Station B have the only two appearances of DN 2000, which 
has an associated voice mailbox. 


1 Delete station A and respond YES to the Delete VMB dialog. 

2 Delete station B and respond NO to the Delete VMB dialog. 

If station A is scheduled before station B, the mailbox is deleted on Meridian 
Mail. If station B is scheduled first, the mailbox will not be deleted. 


Example 2—Adding a Mailbox 


Station A has single appearance of DN 2000, which has an associated voice 
mailbox in TRN status. 


1 Change DN on station A to 2001 (this deletes the VMB record for 2000). 
2 Add station B with DN 2000 and create a new voice mailbox for it. 


If station B is scheduled before station A, the transmit will fail when it 
attempts to create a new mailbox for DN 2000. It will exist on the system until 
station A is transmitted. 

Example 3—Changing a DN 


Station A and station B both have an appearance of DN 2000, which has an 
associated voice mailbox. Station B is in TRN status. 


1 Update the mailbox via station A. 
2 Before transmitting station A, change DN 2000 to 2001 on station A. 


When station A is transmitted, the updates to the voice mailbox are not made, 
because station A no longer has an appearance of DN 2000. 
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Global Update 


Overview 


The Global Update function is available in both the Station Administration 
and the CPND Administration modules. It lets you change common data 
values in each of selected items in the main application window (Station list 
or CPND list) either directly or through a confirmation option. 


The Global Update procedure involves the following steps: 


1 Select those list items that you wish to update. You can use the Select feature 
to select stations based on specific criteria. 

2 Select a field for update. 

3 Define the update or updates to perform on a selected field in the selected 
items. 

4 Execute the change. 


You can perform the update on all selected items directly, or you can do it 
through a confirmation option on an item-by-item basis. 


If you are running in Installation mode, you are prompted to set up 
communication with Meridian 1 whenever you modify a data record. You can 
synchronize the data now, schedule a time for synchronization, or cancel the 
prompt and schedule synchronization later. See “Communicating with 
Meridian 1” on page 97 
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Selecting Data Items 


In a data list window of Station Administration or CPND Administration, 
select the items you wish to update. You can change the current selection as 
follows: 


1 Click to select a single item. 


2 Use the space bar to turn off all selections and select only the first station in 
the list. This method of selection turns off all other selections, leaving only 
the single current selection. 


3 To select multiple stations, hold down the <Shift> key and click a station, or 
press the space bar, to toggle the selection status of that station without 
affecting other selections. If you hold down the <Shift> key you can use the 
up and down arrow keys to add the next adjacent item to the highlighted list. 


Choose Edit - Select All to select all items, or you can define criteria to select 
a group of stations using Edit - Select. 


Define Selection Criteria 


To define criteria for record selection, choose Edit - Select in the Station view 
of the Station Administration window or in the CPND Administration 
window. This displays a Record Selection Criteria dialog in which you enter 
the expression defining the selection criteria. 


Figure 33 
Record Selection Criteria dialog 
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An expression is a formula that follows standard mathematical conventions 
regarding the use of brackets (f }) and the order of operations (add, subtract, 
multiply, or divide). Operations can act on numeric data or on field values 
from the MAT database. Field names must be exactly as defined in the MAT 
database. You can enter the desired expression by typing it in the text box 
directly, or by using the selection criteria and operation buttons provided. 
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The dialog has buttons that allow you to select fields, operators, and functions 
to build a valid expression. You may have to modify the position of brackets 
when completing the expression. 


When you have finished creating a valid expression, click OK to display the 
Station Administration window. Those items which fit the criteria are 
highlighted. You can still modify this selection as described in “Selecting 
Data Items” on page 84. 


Select Data Field 
When you choose Data Field, a list of available fields is displayed in a Select 
Data Field dialog: 


Figure 34 
Select Data Field dialog 











Select the desired station or CPND field name and click OK to paste the field 
into the Select Criteria expression text box at the current cursor position. You 
can type a letter to scroll the listing to the next item starting with that letter. 


Select System Field 
When you choose System Field, a list of available fields is displayed in a 
Select System Field dialog. 


Select the desired field name and click OK to paste the selected field name 
into the Select Criteria expression text box at the current cursor position. 
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Figure 35 
Select System Field dialog 
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Select Function 


A function can generate a value on its own, or it may act on the field directly 
after it in the expression to produce a value that depends on that field value. 
When you choose Function, a list of available functions is displayed in a 
Select Function dialog. 


Figure 36 
Select Function dialog 
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Select the desired field name and click OK to paste the selected function name 
into the Select Criteria expression text box at the current cursor position. 


P0876405 Standard July 1998 


Global Update Page 87 of 194 


Select Operator 

An operator causes a mathematical combination of field values (arithmetic, 
Boolean, conditional, and so on). When you choose Operator, a list of 
available operators is displayed in an Operators dialog. 


Figure 37 
Operators dialog 





Select the desired operator and click OK to paste it into the Select Criteria 
expression text box at the current cursor position. 


Selecting the Items for Change 
When you have completed the selection criteria expression, click OK to return 


to the Administration list window. All items that meet the defined criteria are 
highlighted. 


Example Expressions 


Below are examples of selection expressions to help you understand the 
Select feature. 


Example 1 


Select all stations that have been changed in the MAT database since the last 
transmission to the switch. 
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The SYNCH field shows synchronization for the sets in relation to the 
Meridian 1 database. If the synch status of the set is TRN (for transmitted) 
then all changes have been transmitted to the switch and the data is 
synchronized with the switch. Any other status (NEW, OUT, CHG, RPL) 
identifies a set that has been changed on MAT and needs to be transmitted to 
the switch (see the Sync Status section for details.) 


In order to select all stations that need to be transmitted, you can either select 
all stations in NEW, OUT, CHG or RPL status or you can simply select all sets 
that are not in TRN status. The selection will be the same in either case. For 
this example, we'll choose all sets that are not in TRN status: 

1 Choose Edit - Select. 

2 From the Data Field list choose SSTAT. 

3 Click <> (not equal to) from the Operator list (or simply type in <>). 

4 


Type in "TRN" (Note: all strings must be enclosed in quotes. Column 2 in the 
Data Field List identifies the field as either a string or numeric). 


5 The complete command in the Record Selection Criteria edit box is as 
follows: 

6 STATION->SSTAT<>”TRN” 

7 Note that instead of following steps 2-4 you can simply type in the expression 
above. 

8 Click OK. 


All stations will be selected except those in TRN status. 


Example 2 


Select all stations with a prime DN between 4000 and 5000. 


To select all stations within this range, select all sets with PRIMEDN>4000 
and PRIMEDN<5000. MAT will allow you to do this by following these 
steps: 

1 Choose Edit - Select. 

2 Select PRIMEDN from the Data Field list. 

3 Select > from the Operator list (or simply type in >). 

4 Type in “4000”. 
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From the Operator list select AAND. 

Select PRIMEDN from the Data Field list. 

Select < from the Operator list (or simply type in <). 

Type in “5000”. 

The complete command is as follows: 
STATION->PRIMEDN>”4000”.AND.STATION->PRIMEDN<“5000” 
Click OK. 


All stations that have a prime DN between 4000 and 5000 will be selected. 


Example 3 


Select all M2616 sets with class of service CFXA. 


A Un B QU N nm 


Choose Edit - Select. 

Select INST from the Data Field list. 

Select = from the Operator list (or simply type it in). 

Type “M2616” (criteria is case sensitive; make sure you use a capital M). 
Select AND. from the Operator list. 


Select CFXA from the Data Field List (the mnemonic CFXA represents Call 
Forward which can be either allowed “CFXA” or denied *CFD"). 


Type in “= CFXA”. 
Click OK. 


All M2616 type stations with Call Forward External Allowed (CFXA) will be 
selected. 


Specify the Change 


You can perform a global update on a single field in each item selected in the 
list window. Once you have selected the desired items for update, you select 
the field to change. 
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Select the Field to Change 


When you choose Edit - Global Update, the Select Data Field dialog list 
appears. The fields listed include only those that can be changed globally. For 
example, the Instrument (INST) field is not included in this list because some 
of the fields and their values in the record depend on the instrument. 


When you have selected the field to change, click OK to display the Global 
Change Specification dialog. The selected field name is displayed in the 
Mnemonic box. The example below shows the entries required to change all 
selected station departments to “Dept. X". 


Figure 38 
Global Change Specification dialog 
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The Global Change Values edit list box lets you set up the changes in the field 
values of the field indicated by the Mnemonic box. The list box contains a list 
of changes that you define by entering values in the Old Value and New 
Value fields. 


Note: The Old and New Value text boxes are case-sensitive. The values 
must be entered in the same case as is used in the MAT database. For 
example, “Dept. B"and “Dept. b" are not the same values. 
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Perform the Global Change 


When you click OK in the Global Change Specification dialog, the Global 
Change dialog appears. This dialog is a status dialog only (you cannot edit 
any of the fields). 


Figure 39 
Global Change dialog 





The dialog contains a Station Definition area to identify the station currently 
being changed. The Change area displays the Old and New Values. 


If you are not using change confirmation, a “percentage done” bar informs 
you of the progress of the changes. 


While the change is in progress, the dialog displays the Cancel and Help 
buttons. Help displays help for this dialog and Cancel halts the change task. 


WARNING 
If you click Cancel, there is no way of controlling which records are changed and which are not. 


When the task is complete, the Cancel button is replaced by an OK button. 
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Change Confirmation 


If you elected to confirm changes, a Confirmation dialog asks you whether to 
“Change this record?", for each station record in turn. The Global Change 
dialog contains Station identification and Change identification data for the 
current field. 


You can move this dialog in the same way as other Windows dialogs in order 
to see the progress bar and function buttons in the Global Change box. 
The Confirmation dialog displays the following buttons: 


e Change: Perform the change indicated in the Global Change data box 
and proceed to the next station. 


e Skip: Proceed to the next station without changing the current one. 

* Change All: Proceed with all remaining changes without confirmation. 
e Cancel: Cancel all remaining changes. 

During the change process, the progress bar changes and the Global Change 
data area is updated. 


Change Completion 


When the Global Change task is complete, the Confirmation box is cleared, 
the Global Change box indicates 10096 completion, and the Cancel button is 
replaced by an OK button. 


Click OK in the Global Change dialog to return to the list window. 


Global Update—Wildcards, Matching, and Allowed Fields 


If you choose Edit - Global Update, you build a list of changes for a single 
field on the selected records. The list of changes is built by adding requests to 
change Old Value to New Value for the chosen field. To improve efficiency 
and to shorten the list of changes, you can use * (asterisk), the wildcard 
character. The wildcard matches any value in the field. 


Wildcard matches that you specify are always done after the other Old Value 
matches have failed. Otherwise, matches are attempted in order. For each 
selected record, the first change request that matches the Old Value is 
implemented. 
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Key* allows you to update a feature when the key on which the feature resides 
is unknown. For example, suppose you wish to update the Conference key on 
all sets to No Hold Conference/Autodial. The Conference key may exist on 
any key of the selected station(s). Key* allows you to update the key feature 
without knowing the key number. MAT searches for the first occurrence of 
the feature specified, and updates that key per the instructions. See “Global 
Update—Examples" on page 93 for more detail. 


Certain fields on the station may not be changed with the Global update 
facility: 


* Location must be unique for each station, so Global update is not 
permitted. 


e Station type may not be changed with global update. 


e Certain administrative features of a station, including color and type 
cannot be changed. 


Update—Examples 


A few examples are provided below to help you use the Select and Global 
Update features. These examples provide the basic steps for selecting stations 
based on certain criteria and updating common fields. These methods can be 
applied to a variety of Global Update situations. 


Example 1 
Suppose you wish to change all DNs in the range 4000-4999 to a 5 digit 
54000-54999. You wish to apply this change to all stations for Customer 1. 


1 Global Update is applied to selected stations only. You should therefore select 
all stations for Customer 1. Choose Edit - Select. Click on Data Field and 
choose the Customer Number field to build the expression 
STATION->CNUM = 1. (The STATION->CNUM portion is provided 
automatically when you select Customer Number from the list of Data 
Fields). 


If there is only one customer on the Meridian 1 system, use Edit - Select All 
to select all the stations for this DN change. 
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2 


Choose Edit - Global Update to specify the DN change. 


Example 2 
Suppose you wish to change all Conference keys (A03) on all stations to No 
Hold Conference/Autodial keys (CA). Conference may currently be 
configured on any key on the selected stations. 


1 
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Specify the field to be changed in the Select Data Field dialog. MAT 
provides a special field called All Directory Numbers. You can move 
the highlight in the Select Data Field dialog until the All Directory 
Numbers field is highlighted. Click on OK to select the All Directory 
Number field. 


In the Global Change Specification, you are asked to build a list of 
each old value and the new value with which to replace it. The 
Mnemonic field shows that we are working with the field All 
Directory Numbers (ADN). 


Enter the DN range 4000-4999 in the Old Value box. Move to the 
New Value box and enter 54000-54999. To enable this change, click 
Add. The requested change appears in the Global Change Values 
box. (You can Update or Delete each entry in the Global Values box 
by clicking the appropriate button.) 





When you are satisfied with this change request, click OK. 


MAT examines each station to see if any changes need to be made. A 
meter marks MAT’s progress through the stations. Click Cancel to 
halt the updating process. 


For any applicable station, the Global Change dialog displays 
identifying information for the station and the old and new values that 
are to be modified. 


Select the stations to be updated. Since all stations need to be changed, choose 
Edit - Select All. 


Choose Edit - Global Update to specify the desired change. Choose Key 
from the Select Data Field window. (You can move immediately to the Key 
mnemonic by typing in the first letter of the mnemonic, K.) The Global 
Update window appears. A list box allows you to specify which key to 
change. Since you are not sure which key on each station is equipped with 
Conference, use KEY”, the default for this list, to update the feature 
regardless of the key number. 
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Enter the existing value of the key to be changed in the Old Value box, A03 
and TAB. (If the key you wish to change has parameters, tabbing brings up 
the parameter fields.) Conference does not have parameters, so tab moves you 
to the New Value box. Enter the mnemonic of the new feature (in this case, 
CA for No Hold Conference Autodial). Press <Tab> to display edit boxes for 
the parameters associated with the new feature. Enter the appropriate data in 
the parameter fields. 


You can choose to confirm each change. Once you click OK, MAT begins the 
updates. MAT searches each selected station for the first occurrence of A03. 
If A03 is encountered, MAT changes the key to the new value: CA. Note that 
if the station contains multiple Conference keys, only the first will be 
changed. You can run a second global update to change the second 
appearance of a feature. 


Example 3 
Suppose you wish to add a feature to the first blank key on each set, but the 
first blank key may be a different key number on each set. 


The choice of Key* for your Global Update criteria will tell MAT to look for 
the first occurrence of a particular feature on each set selected. When MAT 
encounters that specified feature it will change that first occurrence to the 
specified new feature and then proceed to the next set. In this example, the 
feature we are looking for is a blank feature. Perform the following steps: 


Un Aà UU N E 


Select all the stations you wish to change. 

Select Edit - Global Update. 

Choose KEYGUPD (Key Global Update) from the criteria list. 
Choose the key number KEY?” (this is the default). 


Enter nothing (blank) in the Old Value, enter the new feature mnemonic and 
appropriate parameters in the new value. Select Add to add to the Global 
Update list. 


Click OK. All stations selected will have the new feature added to the first 
blank key. If a selected set does not have any blank keys, the feature will not 
be added to that particular set. 
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Communicating with Meridian 1 


Overview 


A Meridian 1 system can be programmed with relevant station and CPND 
data from the MAT application. The MAT application can also retrieve 
station data from a Meridian | system. For example, you can create a MAT 
database for a system and then upload relevant data to program a Meridian 1. 
You can make modifications within the MAT application and upload these to 
the system. At any time, you can download system data to the MAT 
application for record-keeping or verification purposes. If you have a 
Meridian | system and wish to start using MAT to administer the data, you 
would download the data from the system and update the data in MAT to 
include all MAT administrative and record-keeping data. 


Your PC uses a modem to communicate, through normal telephone wires, 
with a modem in the Meridian 1. MAT Release 5.0 and higher can also use 
an Ethernet connection if it is available on the Meridian 1. The 
communications protocols must be predefined for each system. From the 
MAT Navigator window, select the desired system. Choose File - Properties 
to display the System Properties window. Select the Communications tab to 
define the appropriate communications protocols for this system. 


The Station and CPND modules use the Synchronize menu to schedule 
communications with the system. 
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Communications Considerations 


Retrieving data is a two-stage process. The Meridian 1 data is first 
downloaded and stored in the current working directory (the MAT system 
subdirectory). Parsing converts the data into the MAT data format. This new 
data overwrites (synchronizes) the MAT database for the system with the data 
from the Meridian 1. The Meridian | data can be parsed at any time after 
retrieval. 


MAT requests a customer number for all data retrievals in order to enforce 
the Meridian 1 Limited Access to Overlays (LAPW) restrictions. If the login 
password associated with the entered customer number is restricted from the 
print routines needed for synchronization, the data will not be retrieved. 


Station Retrieval—TTY Port Configuration 

During the synchronization retrieval operation, MAT requests a print of the 
information on the Meridian 1 through the SDI port. The port used for Station 
Administration retrieval should be configured only as a Service Change port. 
The MAT System Terminal application can be used to access Overlay 17 to 
temporarily configure the TTY port as SCH only (not required for Ethernet 
connections). If the port is configured for other data such as Traffic or 
Maintenance messages, MAT will attempt to distinguish this data from 
relevant station data. The retrieval log will give errors when data is not 
recognized as station data. 


Station Retrieval Log Window 
During station retrieval, the amount of activity in other Windows tasks should 
be limited. 


During long station retrievals, or if there is enough activity in other Windows 
processes, the capacity of the communications buffer can be exceeded. This 
condition will terminate the retrieval process to prevent erroneous data from 
being entered into the station database. 


To prevent this occurrence, the Log Window will automatically minimize 
itself. The icon will be labeled “Log Window:” and will contain the current 
site and system names. You should wait momentarily and restore the Log 
Window to check the progress of the retrieval. 
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The Log Window remains on the screen longer if you resize it to contain 
fewer lines. The amount of window resizing and moving during station 
retrieval should be limited, since these activities will prevent the retrieval 
activity from processing incoming characters. 


If the capacity of the communications buffer is exceeded during the retrieval, 
necessary data is being lost. The MAT software displays a message and 
terminates if the buffer is exceeded. In this case, stations are not added to the 
MAT PC database. The message is printed to the log file, warning that the 
data has been lost. 


Repeat the retrieval to add the new station data. It is possible to retrieve a 
portion of the stations on the Meridian 1 by choosing Synchronize - Retrieve 
- Specify. 


The Communications Task 


Synchronization is a task that ensures that the MAT database reflects the data 
on the Meridian | system. The task can be achieved in two ways: 


e Retrieve Meridian 1 data to the MAT database (download). 
e Transmit MAT data to Meridian 1 (upload). 


Note: It is recommended that you turn off all TTY messages (including 
bug messages) during download or upload. 


Whenever you require access to a Meridian 1 that is defined as a system for 
the MAT application, use the Synchronize menu of the MAT module you are 
currently using (Station or CPND). You can use this menu to schedule upload 
or download of selected data, or you can define criteria to download or upload 
specific station or CPND data. Whenever you modify the MAT database, you 
are prompted to set up a transmit task to upload the new or modified data to 
the Meridian 1. 


Synchronization 


Whenever a communication task has been defined, you are prompted in a 
Synchronize dialog box to set up a schedule for the task. 
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Figure 40 
Synchronization dialog 
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Warning: Remember to clear the communication log file 
periodically. 





The following data can be entered to schedule a task: 


Priority 


The Priority drop-down list box contains the numbers 1 through 10, 
representing the priority level for the task. The number 1 represents 
High, 6 represents Medium and 10 represents Low. The default is 
Medium. Change the priority by selecting an item, or enter the number 
in the text box. 


The Priority number determines where, in the current communications 
task queue, this task is placed. 


Hold Till 


Hold Till is made of two text box fields that determine when this task is 
sent to the communications queue. 


Date 
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The date for the task in the format MM/DD/YY, where MM is the two 
digit month in the range 01-12, DD is the two digit day in the range 
01-31, and YY is the two-digit year. The default entry is the current date 
(leading zeroes are dropped when the input is validated). 
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Download 
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Time 


The time for the task in the format HH:MMXxX, where HH is the two-digit 
hour in the range 01-12, MM is the two-digit minutes in the range 00-59 
and XX is AM or PM representing before or after 12:00 noon. The default 
entry is the current time. 


Description 
Station Update - Station Transmit 
CPND Name Update - CPND Name transmit 
CPND Update - Configuration transmit 
Change as replace 


This field is only available if MAT is in Maintenance mode. See “Station 
Administration” on page 7. 


If you accept the default entries, the task is scheduled immediately. 


Click OK to send the task to the Scheduler module of the MAT application. 
If the task is not immediate, the Scheduler runs iconized on the desktop. The 
Scheduler must be running at the scheduled time for the task to be sent to the 
communications task queue. 


You are not required to schedule a task at any particular time. You can click 
Cancel in this dialog and use the Synchronize menu at any time to schedule 
a task. 


This task updates the MAT database with selected data from the Meridian 1. 
You can select data items in the current list window (Station or CPND) or you 
can define criteria for system data to be retrieved. 
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When you choose Synchronize - Retrieve, a submenu allows you to select 
criteria for downloading selected station data. The submenu contains the 
following items: 


All: All data for stations or CPND in the system 
Selected: Only items selected in the current list of CPND or stations 


Since: Only stations on the system that have changed since a specified 
date (not applicable to CPND) 


Specify: Define criteria for stations or CPND data on the system for 
download 


Parse Only: Parse previously retrieved data 
Log: View or clear a log of communications activity 


Retrieving All Data 


You can set up communications with the system to retrieve all data (station 
or CPND) that pertains to a single customer in the Meridian | system. 


Station Retrieve All 


Choose Synchronize - Retrieve - All of the Station Administration module to 
display the Station Retrieve All dialog. 


Figure 41 
Station Retrieve All dialog 
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The dialog contains the following data entry field: 
Customer 


A single-line drop-down text box with a list of the customer numbers 
defined for the open system. The text box contains the currently selected 
item. 


When you click OK, you are prompted to set up the communications task. 


Note: During station retrieval, the hardware list is updated with cards 
that support the type of stations being configured in MAT. These might 
not be the exact type of hardware cards actually installed in the 
Meridian 1. However, they will be cards with equivalent function as the 
installed cards. 


CPND Name Retrieve All 
Choose Synchronize - Retrieve - All from the CPND Name view to display 
the CPND Retrieve dialog. 


Figure 42 
CPND Name Retrieve dialog 
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The CPND Retrieve dialog contains the following data entry fields: 


Customer Number: A single-line drop-down text box with a list of the 
customer numbers defined for the open system. The text box contains the 
currently selected item. 


Language: A single-line drop-down text box with a list of languages 
defined for the open system. The text box contains the currently selected item. 


Station Administration User Guide 


Page 104 of 194 Communicating with Meridian 1 


DNIS IDC: A text box in which you can enter the DNIS IDC for this group 
of CPND entries. 


Display Format: A single-line drop-down text box with a list of the CPND 
name display formats defined for the open system. The text box contains the 
currently selected item. 


When you click OK, you are prompted to set up the communications task. 


Selecting Data to Retrieve 


You can select items in the Station list or CPND list window that you want to 
download from the Meridian 1. See “Global Update” on page 83. Meridian 1 
data overwrites the data currently stored in the MAT database for the selected 
items. When you choose Synchronize - Retrieve - Selected, you are 
prompted to set up the communications task. 


Retrieve Since Option 


In the Station Administration module, choose Synchronize - Retrieve - 
Since to display the Retrieve Since dialog. 


Figure 43 
Station Retrieve Since dialog 
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The dialog contains a single field: 


Date: This text box contains the date in the format MM/DD/YY, where MM is 
the two digit month in the range 01-12, DD is the two digit day in the range 
01-31, and YY is the two-digit year. 


When you click OK, you are prompted to set up the communications task. The 
task retrieves all data that has changed since the specified date. 
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Note: During the Synchronization Retrieval operation, MAT requests a 
print of the information on the system through the SDI port. MAT 
attempts to distinguish relevant data from other messages that might also 
be passed through the same port. Examples include traffic and 
maintenance messages. You might find that it helps the accuracy of the 
MAT retrieval process to temporarily disable other uses of this port. 


Specifying Data to Retrieve 
Advanced users can specify stations or CPND (Name or Administration) or 
Reserved Unit Type (RUT) data with a one-to-one correspondence of data in 
certain fields for retrieval. 


Note: When you retrieve Station Data, CPND names are also retrieved, 
and the Station View is updated accordingly. 


Station Retrieve Specify 

Choose Synchronize - Retrieve - Specify option in the Station module to 
display the Station Retrieve Specify dialog. Enter the data pertinent to those 
stations on the system that you wish to download. By default, all fields in the 
dialog are blank. All stations are downloaded if no data is specified. 


Figure 44 
Station Retrieve Specify dialog 
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Criteria you can set for station selection include: 
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Customer 


A single-line drop-down text box with a list of the customer numbers 
defined for the open system. The text box contains the currently selected 
item. 


Type 


A single-line drop-down text box with a list of the instrument types 
(telephones) available for the open system. The text box contains the 
currently selected item. 


Note: Station Retrieval—Using Type = 2000 
You can use this Meridian 1 feature to retrieve all 2000 type sets 
from the Meridian 1 system. In the Retrieve Specify dialog, move 
to the Type box. You can type 2000, although it does not appear in 


the list box. MAT will correctly respond to the Type prompt during 
retrieval. 


Terminal Number 


Enter a TN or partial TN to retrieve only those stations attached to the 
part of the Terminal Number entered. 


Card Density 


This single-line text box allows you to enter the card type. The card type 
value is associated with the terminal number. 


Designator 


Enter a designator value in this field to retrieve all stations with this 
Designator. 


Tenant 
Enter a Tenant value in this field to retrieve all of that Tenant's stations. 
Date 


This field accepts a date in the format MM/DD/YY, where MM is the 
month in the range 01-12, DD is the day in the range 01-31, and YY is the 
two-digit year. This retrieves all stations modified after the specified 
date. 
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Note 1: If you request a retrieval from a large Meridian 1 system, using 
Specify and the Type, it could spend a long time selecting the appropriate 
stations. If the time-out period (set in system properties) is not long 
enough, MAT will determine that no more information is being sent by 
the Meridian 1 and halt the retrieval. 


The number of stations retrieved is stated in the Retrieval Log. The 
time-out parameter can be lengthened to give the Meridian 1 sufficient 
time to find the appropriate stations to transmit. However, a long 
time-out period also lengthens the time required by MAT to correctly 
identify that the Meridian 1 has no more information to send. You need 
to be patient if you extend the time out period beyond the default values. 


Note 2: MAT is able to retrieve selected stations from a Meridian 1 
Option 11. You can also retrieve all stations on an Option 11, or choose 
Synchronize - Retrieve - Specify, using a partial TN. 


CPND Administration Retrieve Specify 

You can retrieve customer-specific CPND Administration data from the 
Meridian 1. Choose Retrieve - Specify in the CPND Administration view 
window to display the CPND Retrieve Specify dialog. 


Figure 45 
CPND Retrieve dialog 
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There is a single field in this dialog: 


Customer Number: A single-line drop-down text box with a list of 
customer numbers defined for the open system. The text box contains the 
currently selected item. 
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CPND Name Retrieve Specify 


If you want to define the CPND name data for downloading, choose Retrieve 
- Specify in the CPND Name view window to display the CPND Name 
Retrieve dialog. 


Figure 46 
Name Retrieve Specify 
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Note: CPND Name Retrieval—Synchronization prompt 


When retrieving CPND names from the Meridian 1 (using Overlay 95), 
MAT prompts you for additional information necessary for retrieval. The 
additional information differs depending on the software release of the 
Meridian 1. 


Display Format: before Release 19 of the Meridian 1, the Display 
Format was required for name retrieval. Beginning with Release 19, 
Display Format can be part of each CPND entry. Therefore, for 
Meridian 1 systems previous to Release 19, you are prompted for 
Display Format during name retrieval. For Meridian 1 systems 
beginning with Release 19, you are prompted for Display Format only if 
MAT does not find a valid Display Format. If MAT does not prompt for 
the Display Format, the applicable format is displayed, but not enabled 
for modification. 
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The criteria you can set for CPND name selection include the following: 


Customer Number 


A single-line drop-down text box with a list of the customer numbers 
defined for the open system. The text box contains the currently selected 
item. 


Language 


A single-line drop-down text box with a list of languages you can use for 
the display. The text box contains the currently selected item. 


Directory Number 


A numeric field that accepts up to 9 digits that represents the DN for this 
station. You can double click this field to display the list of currently 
assigned numbers in the numbering plan for the open system. You can 
select the number for this station in the Directory Numbers dialog. This 
is described in “Directory Number Assignment” on page 25. 


Display Format 


A single-line drop-down text box with a list of the CPND name display 
formats defined for the open system. The text box contains the currently 
selected item. 


Entry Type 


A selection field containing three radio buttons for the type of entry for 
this station. The choices include: 


Directory Number: required to enter Directory Number 
Dial Intercom Group: required to enter Group Member 
DNIS IDC: required to enter DNIS IDC table number and DNIS IDC 


When you click OK, you are prompted to set up the communications task. 


Note: When you retrieve Station Data, CPND names are also retrieved, 
and the Station View is updated accordingly. 
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Synchronization status and Retrieval 


If MAT performs a retrieval, including station and CPND name, the 
Synchronization Status determines whether the MAT data is updated. In all 
cases, the Retrieval log contains a record of the retrieval and the results of any 
comparisons with an existing Meridian 1 system. 


e NEW: The data for this station should not exist on the Meridian 1 system 
and the station will not be updated. 


e  TRN: The data for this station in MAT should agree with the data in the 
Meridian 1. The MAT data is updated to reflect the current configuration 
on the Meridian 1. 


e CHG, RPL: The data for this station have been changed since the last time 
the MAT and Meridian 1 have been synchronized. The station is not 
updated. 


e OUT: The MAT user has marked this station for deletion, the current 
configuration of the station on the Meridian 1 is not relevant. 


Upload 


This task updates the Meridian 1 data block with selected data from the MAT 
database. You can select data items in the current list window (Station or 
CPND). 


When you choose Synchronize - Transmit in the Station or CPND module, 
a submenu allows you to select criteria for uploading data to Meridian 1. The 
submenu contains the following items: 


Selected: Upload only selected items in the current list of CPND or 
stations. 


Log: View or clear a log of communications activity. 


Selecting Data to Transmit 


You can select items in the Station list or CPND list window to upload to the 
Meridian 1 (refer to “Global Update" on page 83). The MAT data overwrites 
the data currently residing in Meridian 1 for the selected items. When you 
choose Synchronize - Transmit - Selected, you are prompted to set up the 
communications task. 
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Communications Logs 


All communications activity is recorded in log files that are stored in the 
current working directory of your MAT administration modules. There are 
five separate log files. The names follow normal PC conventions, as follows: 


e RTRSTN.LOG: Station data retrieve 

e TRNSTN.LOG: Station data transmit 

e  RTRNAME.LOG: CPND data retrieve 

*  TRNNAME.LOG: CPND data transmit 

e  OVL81RTR.LOG: Reconcile data transmit noting deleted sets 


information 


Each of these logs is accessed from the Log menu in the appropriate module's 
Synchronization - Transmit or Receive menu. 


When you choose Log, à submenu provides the following items: 


View: Sends the log file to the viewer so you can browse or print the log. Log 
activity is appended to the end of the file, so the most recent activity is at the 
bottom of the viewer. See “The MAT File Viewer” on page 129. 


Clear: Clears the log file. You should do this occasionally so that the file does 
not get too large. 


Note 1: There is no limit to the size of the log files, but there is a limit 
to the size of log files that the viewer can handle. There is a 100-page 
limit on log files for viewing from Synchronize - Log - View. 


Note 2: During station retrieval, you should limit the amount of activity 
in other Windows tasks. During long station retrievals, or if there is 
sufficient activity in other Windows processes, the capacity of the 
communications buffer can be exceeded. This condition terminates the 
retrieval process to prevent erroneous data from being entered into the 
station database. 
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You might notice that the Log window minimizes itself to prevent this 
occurrence. As the communications buffer starts to fill excessively, the 
Log window is minimized to allow faster processing of the incoming 
data. You should wait momentarily and restore the Log window to check 
the progress of the retrieval. 


The Log window will remain on the screen longer if you resize it to 
contain fewer lines. Similarly, you should minimize the amount of 
window resizing and moving during station retrieval, since these 
activities momentarily prevent retrieval activity from processing the 
incoming characters. 


If the capacity of the communications buffer is exceeded, necessary data 
is lost to MAT. MAT displays a message and terminates the station 
retrieval process. You will notice that the stations were not added to the 
MAT PC database. 


You can repeat the retrieval to add the new station data. Alternatively, 
you can choose Synchronization - Parse Only to add the downloaded 
data to the MAT PC database, and continue the retrieval process from 
where it stopped. It is possible to retrieve a portion of the stations on the 
system by choosing Station Retrieve - Specify. 


Viewing large log files 
There is currently a 100-page limit on the size of log files and reports that can 
be displayed on the screen. This limit affects Synchronization - View - Log 
and Reports menu items. A message appears to warn you that the file is too 
large to be viewed in its entirety, and only the first 100 pages are displayed. 
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You can avoid this limit by: 


e Periodically using Synchronization Log - Clear to prevent text from old 
retrievals or transmissions from unnecessarily adding to the size of the 
log file. 


* Testing large reports on a portion of the data, using the Filter feature in 
the Report Form menu. For example, you can limit the report to the first 
200 records by opening the report form and selecting the Options - 
Report Filter. To limit the number of records, click the System Fields 
button, select the REC_COUNT field and build the expression 
SYS--REC COUNT <= 200. If a Report Filter already exists, this clause 
can be added using the .AND. operator. 


e Viewing large files with another program. These files are too large for 
the Windows Notepad, however. 


Transmission errors during retrieval 


You should inspect the Retrieval Log after performing a synchronization. 
This log reports the number of stations added, the number of stations 
compared, and the number of stations with discrepancies from that 
comparison. In addition, the Retrieval Log might contain warnings from 
unrecognized data during the transmission. The unrecognized data might be 
the result of transmission problems. 


Compare the expected number of stations to be retrieved to the number of 
stations actually retrieved. If too few stations were retrieved, look for 
warnings in the log file that indicate that not enough data was correctly 
received to recognize the station. 


You should also note the number of compared stations. The first retrieval into 
the MAT PC database should only be adding stations. If any stations were 
compared, it might indicate a transmission error in the TN field that caused 
MAT to treat this station as an update to an existing station, instead of 
creating a new station. 
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Reconcile TN Feature 


This tool corrects synchronization problems that may arise when changes are 
made to station data outside of MAT. These changes may include Set 
Removal, Set Relocation done through a TTY using Overlays 10 or 11. The 
switch database is changed but the MAT database on the local PC is left 
unchanged. 


MAT users launch the Reconcile TN feature from the Synchronize menu in 
the Station Administration window. MAT compares the listed sets 
information with information in the MAT database against the switch 
database to determine which TNs are valid. Invalid TNs are removed. All 
removed TNs noted in a log file viewable under the Synchronize - Reconcile 
- Log - View menu. See Figure 47. 


Figure 47 
Viewing the log file 


E mpk - mpk5 - Station Administration 
Sync! Forms Options Help 


Believe > 
Transmit > be — 


cile Terminal Numbers | Jun 


004-0-01-01 TRN 2789 Dem f1 01 


004-0-01-02 TRN 3956 004 0 01 02 
004-0-02-00 TRN 2945 004 0 02 00 
004-0-02-01 TRN 2970 004 0 02 01 
004-0-02-02 TRN 2946 004 0 02 02 
004-0-02-04 TRN 2948 004 0 02 04 
004-0-02-05 TRN 2909 004 0 02 05 
004-0-02-06 TRN 2953 004 0 02 06 


Station Forms 


Note: The Reconcile TN feature requires some time to complete its 
function and can degrade system performance. Do this task when switch 
traffic is low or after hours to minimize the effect on the system's 
performance. User should back up the existing database before starting 
this function. 
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Overview 


The MAT Conversion utility provides two functions: 


e Rebuild of station data to the current MAT file structure. You might need 
to run this conversion if you have copied system data to your current 
release directories that was built in an earlier release. 


e Import of station data from other applications. 


Starting the Conversion utility 


When you choose File - Conversion utility in the Station Administration 
module, the MAT Conversion utility window opens. 


Figure 48 
Conversion utility window 
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The window initially contains no data in the workspace. The menu bar 
contains the following drop-down menus: 
e File 
e Rebuild File 
e Help 


You can select the desired menu using the mouse (Click) or keyboard 
(Alt+Bold Character) in the normal way. 


File Menu 


The File menu provides the following functions: 


Import: Lets you insert station data from another database into the current 
system. 


Close: Quits the Conversion utility. 


Rebuild File Menu 


MAT administration can change the file structure of certain files. This can 
cause file errors during system maintenance. The Rebuild Files menu lets you 
check the individual files of system data and convert them to conform with 
the current file structure being used by MAT, if necessary: 


All Systems: This option automatically searches the PC system for MAT 
systems and transforms selected files, if necessary. 


Auto: This option automatically checks and transforms all files for each 
system, if necessary. 


Select Files: This option lets you select MAT data files that will be checked 
for all systems, and transformed, if necessary. 


Current System: This option checks selected files of the current system and 
transforms them if necessary: 


Auto: This option automatically checks and transforms all files for the current 
system, if necessary. 


Select Files: This option lets you select MAT data files that will be checked 
and transformed for the current system 
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Help Menu 


The Help menu provides on-line help for the Conversion utility. 


Rebuilding Files 
The MAT administrator can modify the file structure used in MAT. This can 
result in File Errors during MAT processing. When this occurs, you can use 
the Conversion utility to rebuild the files, making their structure correspond 
with the current MAT file structure. In practice, the Conversion utility would 
check the structure of selected files and rebuild only if necessary. 


Accessing the Files 


To access the MAT data files for the Rebuild option, choose Rebuild File - 
All Systems or Rebuild File - Current System. Each option displays a 
cascading secondary menu that lets you choose to automatically detect files 
that require rebuilding or to manually select files for rebuild. 


If you choose to select files, a Select Files dialog is displayed. This dialog 
contains a multi-selection list of files that comprise the MAT data. Selected 
files are indicated by highlight bars. Use the Windows vertical scroll bar to 
browse the entire list of files. Mouse click an item to toggle its selection 
status. 


Click OK in the Select File dialog to start the rebuilding task for the selected 
files of all systems or the current systems as required. 


Monitor Rebuilding Files 
The Conversion utility checks all the selected files in each system and 


rebuilds all files it finds that require rebuilding. During this task, a status 
dialog is displayed that informs you of the progress of the task. 


Upon completion, a status of Success is displayed. At any time you can click 
Cancel in the Status dialog to halt the rebuilding task. This might result in 
some files not being rebuilt. Another attempt at Rebuilding Files would now 
complete the task. 
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Conversion utility 


Importing Station Data 


Station data is stored in accordance with the file structure and database rules 
defined in the MAT application. The Conversion utility provides a merge 
function (Import) that lets you update station data, and add new stations, from 
a data source other than a Meridian 1 (data defined in DBASE or CPLUS, for 
example). 


Note that the merge function uses the DN as the key so that any imported data 
must include a DN field. Also note that, if the supplied DN is not currently 
used in the open system, the record will not be added unless a valid unique 
Location field (LOC) value is supplied. This means that to create a new 
record you must supply both a currently unused DN and a unique Location. 


Data for import must have a Fields Definition file (default but not limited to 
files with.FLD extension) as well as a comma delimited data file (default but 
not limited to files with .TXT extension). The field file will identify which 
items in the data file belong to which MAT fields. 


Note that the Fields Definition file must have the exact field names as defined 
in MAT. These can be found in the Select Data Field dialog in the Global 
Update function. The fields will be in the order in which the data is listed in 
the data file. 


Considerations When Merging Key Values and Features 


If you want to add or modify features for a particular record you must identify 
a “FTR” field for each feature being modified. The values must be as used in 
Meridian 1 as identified in the Features dialog when accessing multi-line 
telephone sets. For example, Call Forward when the forward DN is a 
four-digit number would be CFW 4 in Meridian 1. 


If you want to add or modify key functions to a single line telephone, you 
must identify the key as KEY n, where n is the key number (include the 
space). If the value represents a Single Call Ringing key, then the field entry 
would be SCR nnnn, where *nnnn" is the selected DN. 
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Select a Data File 


To select data to import, choose File - Import in the Conversion utility to 
display the Select an Import Text File dialog. The Text File Selection dialog 
lets you select the location and file name of the desired data file. By default, 
the dialog tries to locate files with .TXT extension, but you can actually use 
any extension in the File Name text box. 


Click OK in this dialog to accept the data file name selection and display the 
Field File Selection dialog. 


Select a Field File 


Click OK in the Select an Import Text File dialog to display the Select an 
Import Field File dialog. The Field File Selection dialog lets you select the 
location and file name of the desired field definition file. By default, the 
dialog tries to locate files with .FLD extension, but you can actually use any 
extension in the File Name text box. 


Click OK in this dialog to initiate the merge function. 


Perform the Merge 


When you have completed selection of the data and field files for merging to 
the current system data, click OK in the Select an Import Field File dialog to 
initiate the merge function and display a progress status message box that has 
a percent completion bar. This dialog has a Cancel button that will stop the 
merge before completion. When the progress bar indicates 100%, the Cancel 
button changes to OK. Click OK to return to the Conversion utility window. 


The data is now part of the system and is available through the Station 
Administration module. 
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Example of Import Data 
A typical import file might contain the following data: 
e  “3452”,”Robert”,”Williams”,” Accounting” 
e “3497”,”Marie’,” Astor’, Marketing” 
e  “8732”,”Lee”,”Smith”,” Accounting" 
e “8743”, Arthur”, McKinley” Facilities” 
e "3469","Mary","Owens","Marketing" 


where each record has four fields which would be defined in a separate file, 


as follows: 

* DN 

e FNAME 
e LNAME 
e DEPT 


Note that the merge function uses the DN as the key so that any imported data 
must include a DN field. Also note that, if the supplied DN is not currently 
used in the system, the record will not be added unless a valid unique 
Location field (LOC) is supplied. 
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Generating Reports 


Overview 


The Report Generator module lets you create, view, print, and change custom 
reports. Access the Report Generator module by choosing File - Reports in 
the CPND and Station Administration modules. 


MAT supplies several standard report forms for reporting MAT data. In 
addition, the Reports Generator module contains a form editor that lets you 
create custom report forms or edit existing forms. It also contains a viewer 
that lets you print reports or browse reports on the screen. A report executor 
lets you run the reports to the viewer for screen display, to a file, or toa 
printer. Custom selectable criteria allow you to tailor the report listing. 


Reports Considerations 


All report activity is performed in the current working directory—the system 
subdirectory. All forms are stored in this directory with a *.FRM" extension. 
Exported reports are also saved in this directory and are automatically given 
a “.TXT” extension. This means that you need supply only the filename (up 
to eight characters) when prompted to save a report to a file. 


The MAT Report Generator requires that a printer be configured in the 
Windows software environment, although it is not necessary for the PC 
running MAT to be equipped with a printer. 


Starting the Reports Function 


Choose File - Reports - Report Generator in the Station or CPND module to 
display the MAT Report Generation window appears. 
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Figure 49 
Report Generation window 





There is no data in the work area when the window is first displayed. The 
window contains a menu bar with drop-down menus that let you perform 
global actions within the Report Generator: 


e File Menu 

e Form Menu 

e Report Menu 
e Help Menu 


File Menu 
The only function available from this menu is the following: 


Close: Closes the Report Generator. 
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Forms Menu 


This menu lets you choose a current report form or create a new form. 
New Report Format...: Lets you design a new form for a report. 


Open Existing Report Format...: Lets you open a predefined form for the 
selected data in the system. 


Reports Menu 
This menu allows access to the report executor. 


Run Report...: Displays a dialog that lets you access a report form that you 
can run (to the screen, to a printer, or to a file). 


Running Reports 


Running a report involves selecting a report to run and selecting a destination 
for the report. Selection criteria for the records you wish to choose are 
contained within the report form. If you desire different criteria, you can edit 
the form or create a new one. See “Report Criteria” on page 154. You can 
send a report to a viewer for screen display, to a file, or to a printer. 


Select a Report 


Select a report to run by choosing Report - Run Report in the Report 
Generator. Run Report displays a Select a Form File dialog with a 
single-choice scrollable list of report forms on your system. 


Figure 50 
Select a Form File dialog 
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Generating Reports 

Some reports in the list may be reports you have defined or modified for your 
needs. Default reports supplied with MAT include: 
e Automatic Call Distribution Stations 

e Class of Service 

e Dial Intercom Group 

e List of Power Failure Phones 

* Message Centers 

e Private Line 

e Ringing Number Pickup Group 

e Speed Call Groups 

e System Speed Call Group 

e Telephone Directory by Department 

e Telephone Directory by Directory Number 

e Telephone Directory by Location 

e Telephone Directory by TN 

e Telephone Directory by Name 


The currently selected form is highlighted. Select a form and click OK to run 
a report using the currently selected form. 


Select a Destination 


When you have selected a form and have chosen Report - Run Report, an 
Output Device dialog provides a list of possible destinations for the report. 


The dialog displays a list of destinations for the report. See “View Report" on 
page 125. 


e Screen 
e Printer 


* Export File 


Select a destination and click OK to run the selected report. 
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Figure 51 
Output Device dialog 
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Print Report 


If you selected Printer for the report destination, the MAT Report Generator 
uses the Windows print function to direct the report to its default printer. The 
default printer for the report is identified in the form when it is created or 
edited. If you want to check or change the printer destination or setup you 
must do this from the Form editor before you run the report. Alternately, you 
can send the report to the screen and print from the viewer. 


During printing, a Printing status box is displayed. You can stop the print job 
by clicking the Cancel button. A Report Viewer status box alerts you when 
the job is finished. Click OK to return to the Report Generator. 


View Report 


If you select Screen for the report destination, a viewer appears with the 
report in the work area. 


This Viewer has the following menus: 

File: lets you display a report summary, print the report, or exit the viewer. 
Search: lets you find text contained in the report. 

Help: lets you access on-line help for the viewer. 

See “The MAT File Viewer" on page 129. 


You can print the report from the viewer to the printer defined in the report 
form, orto a printer you choose from the Viewer. You can also save the report 
to a file selected from the Viewer. 
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Figure 52 
Example Report in the Viewer 
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Export Report 


If you chose Export File for the report destination, the report output can be 
saved in a comma-delimited ASCII file. Export File displays a dialog that lets 
you choose a name for the report file. 


Figure 53 
Export File Name dialog 
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You can enter a filename up to eight characters. Click OK to send the report 
to the Viewer. See “View Report’ on page 125. Filename.TXT, a 
comma-delimited text file with the Filename as entered in the text box, is 
saved to the current PC directory. 


Station Administration User Guide 


Page 128 of 194 Generating Reports 


P0876405 Standard July 1998 


Page 129 of 194 


The MAT File Viewer 


Overview 


The Viewer lets you browse, print, and save MAT files accessed during 
Station Administration tasks. You cannot access the Viewer as a separate 
module. It is invoked when you attempt to print or display files created during 
MAT database administration. The files that can be viewed include: 


e Reports 

e Designation Strips 

e Station Validation Log 
e Communication Logs 


e Station and CPND Administration list views 


Viewing a File 


When the File Viewer starts, the scrolling Viewer window contains the data 
from a file created during MAT database administration. The Viewer does not 
allow editing, so the viewed data is in a fixed format. 


You can browse and print the data using the menus, as follows: 


Viewer File Menu 


The File menu lets you display a file summary, save the file to a selected 
directory, print the file, or exit the viewer. 


Save as: Lets you save the displayed data as a text file to your PC system. 


Summary: Displays a file summary of the displayed data. 
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Figure 54 
File Viewer window 
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Print: Sends the file to the default printer (the printer is normally the default 
printer as defined in Windows). However, for reports, the printer is defined 
in the form. 


Printer Setup: Allows you to select a print destination and set printer options. 


Close: This option closes the Viewer and returns to the window that invoked 
it. 
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Viewer Search Menu 


The Search menu lets you find a text string that might be contained in the 
displayed data. 


Find: Lets you define a text string to find. The Find function is not case 
sensitive. 


Find Again: Lets you find the next occurrence of the currently defined string. 
This option is dimmed until you have searched for a string. 


Changing Viewed Data 


The data displayed in the viewer is in a fixed format, defined in MAT, for the 
file being viewed. 


Browsing the File 


The MAT Viewer is a line viewer with the current line highlighted. You can 
use the arrow keys or <Page Up> and <Page Down> to move the highlight 
one line or one screen at a time. You can also use the Windows vertical scroll 
bars to scroll the report, moving the highlight bar as you scroll. The Windows 
horizontal scroll bar lets you browse entire lines when the lines are too long 
for the window. 


Use the Search menu to find selected text. A successful Find highlights the 
line containing the search text. 


Save As 


The file is displayed in the Viewer with a default file name in the title bar. 
You can save the data as an ASCII text file. Choose File - Save As to save 
the current file with a different name or location 


Select a File Name 

The Save As dialog is the standard window used to specify the file name and 
file location (for a full description of this dialog, refer to your Windows 
documentation). The dialog contains a single-selection scrollable drop-down 
list of disks that your PC can access. Select a disk to display the list of 
directories on the disk in a single-selection scrollable Directories list field. 
Select a directory to display a single-selection scrollable list of files in that 
directory. Select an item from the File Name list or type in a file name. 
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Figure 55 
Save As dialog 





At any time, click Cancel to return to the Viewer without saving the file. 
Click OK to save the file with the specified file name. 


The saved file uses the current default Windows font for character formatting. 
Any character formatting in the original file (from a Report, for example) is 
not saved. 

Display a File Summary 


Choose File - Summary to display a File Summary status box. 


Figure 56 
File Summary dialog 





The summary gives the number of lines for a text file (or number of records 
for a database report file) and the number of pages in the file. Click OK in the 
status box to return to the Viewer. 
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Print from the Viewer 


You can print the file (exactly as displayed) to a default printer directly or you 
can select another printer for the task. Choose File - Print to print the contents 
of the Viewer to one of the following destinations: 


e Ifthe Viewer is displaying a report, the print destination is the destination 
defined in the report. If your PC cannot find this printer, MAT displays 
a status message. Click OK in the Status message box to return to the 
Viewer. 


e [fno printer is defined in the file being viewed, the print destination is 
the current printer defined in Windows. This can be the Windows default 
or a printer selected in the File - Print Setup option of the Viewer. 


A progress status message is displayed while the file is printing (or sent to a 
print spooler if applicable). Click Cancel in the Status box to stop printing. 
When the task is complete, MAT returns to the Viewer window. 


Search the File 


Choose Search - Find to display a dialog that lets you enter text you wish to 
find. If Find Again is available, the dialog contains the previous search data. 


Figure 57 
Find Text dialog 
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Click OK to accept the data in the dialog and proceed with the search. Click 
Cancel to return to the Viewer window. Click Help to display on-line help for 
this dialog. 


The text box accepts any input. The find function is not case sensitive. 


The Viewer highlights the line containing the first occurrence of the Find text. 
The Find function always starts at the top of the report, regardless of the 
current cursor position. 
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When the first search is complete, Search - Find Again is available. If you 
choose this item, the highlight bar moves to the next occurrence of the text. You 
can repeat this until a status message indicates that are no more occurrences. 
Click OK in this status box to return to the Viewer. 


When you finish searching, click Cancel to return to the Viewer. 


Printer Setup 


To define the printer destination and setup from the Viewer, choose File - 
Print Setup. 


Figure 58 
Printer Selection dialog 

















The Printer Selection dialog contains a single-selection scrollable list of 
printers accessible to your PC. Click OK to accept the selected printer and 
return to the Viewer window. Click Cancel to return to the Viewer window. 
Click Help to display on-line help for this dialog. 


The Setup button opens the standard Windows printer setup dialog for the 


currently selected printer. Refer to your Windows documentation for 
information on Print Setup. 
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Click Cancel in the Print Selection dialog to return to the Viewer without 
changing the Print setup. Select a printer and click OK to set the selected 
printer as the Viewer default and return to the Viewer. This new printer 
destination is only valid for this viewer session. The report form still retains 
the original print setup. 


Exit the Viewer 


Choose File - Close to close the Viewer and return to the Report Generation 
window. 
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Designing Report Forms 


Overview 


The MAT application includes several pre-designed forms you can use to run 
the most common reports. MAT also includes a Report Generator module that 
includes a Forms editor. The editor lets you modify existing forms or create 
your own forms for customized reports. 


The Forms editor lets you generate a customized layout for a report by piecing 
together predefined report sections. 


Form Section Concepts 


The Report Generator organizes a report by sections. A report form can 
contain one or more sections: 


e Report Header 
e Page Header 
e Sort Header(s) 
e Detail Section 
e Page Footer 


e  Sort Footer(s) 
Each of these sections is optional, but a form must contain at least one section 
and can have only one of each type. Each section allows an internal free 


layout of data. The only restriction is the position a section occupies on the 
report in relation to the other sections. 
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Designing Report Forms 


When you insert a new section in a form, it automatically positions itself 
correctly relative to other sections. This position is indicated in the Editor 
window by a line with the section title printed on it. This line is not part of the 
form, it merely serves as the top boundary of the section it indicates. The list 
above indicates the order in which the sections will appear in the form. 


Arranging sections within a form is described in “Validating the Data" on 
page 39. 


The Forms Editor 


The Forms Editor is an application within the Report Generator that lets you 
design and customize a report using the current database. 


Choose Form - New Report Format to display the Forms Editor, with a 
blank form in the working area. Choose Form - Open Existing Report 
Format to display a dialog that lets you select from a list of forms for the 
current system database. 


Figure 59 
Select a Form File dialog 
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The currently selected form is highlighted. Select a form from the list and 
click OK to invoke the Forms Editor. The Forms Editor contains a menu of 
actions to perform: 
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File Menu 


This menu contains commands for saving the current report file and 
specifying the report parameters. 


Select Report View: Lets you select the key selection criteria that determine 
the content of the report at runtime. 


Save: Store the current report form to a file. If it is a new form, you are 
prompted for a filename (up to eight characters followed by a period and an 
extension of up to three characters). 


Save As...: Store the current report form to a file. Report form files must be 
stored in the common data directory. MAT will not allow changes to the path 
for these files. 


Printer Setup: The Windows default printer is automatically assigned to the 
current form when you save it. This selection lets you select a different printer 
and printer configuration to be associated with the current form from a list of 
installed printers. 


The printer options that you select here determine the width and height of the 
report. The width of the report is indicated by the length of the section 
separation lines in the form editor window. 


Exit: Close the Forms Editor and return to the Report Generation window. If 
the current form has not been saved since the last change, you are prompted 
to save it before exiting the editor. 
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Edit Menu 
This menu contains miscellaneous edit and cursor navigation functions: 


Insert Line After/Before: Puts a blank line following/preceding the current 
cursor position. 


Delete Line: Removes the current line, moving all successive lines up. 


Highlight Off: Turns off any highlighting in the current form (lets you 
deselect text and fields). 


Beginning/End of Line: Moves the cursor to the left/right end of the current 
line. 


Next/Previous Word: Moves the cursor to the beginning of the next/previous 
word or field in the form, going to the next/previous line if necessary. 


Section Menu 


This menu contains commands to insert, edit, and delete report sections. 
New...: Lets you add a section to the current form. Sections include: 


e Report Header: Appears at the top of the report only 

e Page Header: Appears at the top of each page of the report 

e Detail Section: Defines data to be reported 

e Page Footer: Appears at the bottom of each page of the report 


e Sort n Header: The nth sort criterion field for the report (n = 1 - 9) 


The section title is displayed at the current position of the selected section on 
the form. This line indicates the Forms Editor cursor location. It will not 
appear on the printed form. 
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Edit Current...: Lets you define the layout of the section in which the Forms 
Editor cursor is currently positioned. Displays a dialog containing 
check-boxes for defining section layout at runtime. Choices include: 


e Start new page before this section 

e Start new page after this section 

e Do not include blank lines 

e Suppress trailing (or leading) blanks in a field 


e Titles on every page of the report 


Delete Current...: Removes the section in which the cursor is currently 
positioned. 


Sort Field...: Lets you change the current sort field selection. This selection 
is not available unless the form has sort fields defined (use the Section New 
function to insert sort fields). 


Break Field...: In a typical report, the break field is the same as the sort field. 
This selection lets you define a field for a section break that is not a sort field. 


Field Menu 


This menu contains options to insert, modify, delete, and maintain fields. 


Insert New Field: Displays a submenu that lets you choose a field type for 
insertion into the form at the cursor position. Field types include: 


e Data Field: Displays a list of data fields in a record of the system 
database 


e Calculation Field: Displays a box for entering a formula for the field 
e System Field: Displays a list of MAT system fields 


Edit Current Field...: Lets you modify attributes for the current field. 


Edit Field Expression...: If you have a calculated field at the cursor position, 
this selection lets you modify the formula. 
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Options Menu 


This menu lets you define the appearance of the report and select data records 
for inclusion in the report. 


Report Parameters...: Brings up a dialog that allows you to specify certain 
report parameters: 


e Name of the report (This is not the Windows filename.) 
e Margins for the printed page 
e Output of some trial records for form layout adjustment 


e Default date format for input and during execution 


Report Filter...: This option allows you to enter a filter criteria for the report. 
Each data record is tested with the expression that you provide here. A record 
is selected only if this expression evaluates to a TRUE value. For example, if 
the expression was DN- >amount> 1000, then only records with a DN higher 
than 1000 are included in the report. 


Fonts Menu 


This menu contains formatting commands for highlighted characters (and 
field values) at runtime. 


Normal: Removes character formatting, if any) 


Superscript 


Formatting: Normal, Bold, Underline, /talic, j uM" 
Subscript 


Strike. 
Fonts: Lets you select font and size for highlighted characters and fields. 
The report generator allows only fixed space fonts. You should be careful 


that columnar text uses the same font size and spacing to maintain 
column alignment. 


Changing Sections 


Here is an example of a blank form with all sections in place. The sections are 
divided by a line labeled with the section name. These lines are place 
indicators only and will not appear on the printed report. 


The Section menu lets you change the sections as described below. 
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Figure 60 
Example blank report form 
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Insert a Section 


To insert a section in a form, choose Sections - New with the cursor 
anywhere in the Forms Editor window. This displays a Select New Section 
dialog with a list of available sections (all sections that do not appear in the 
form). 


The currently selected Section is highlighted. Select a section and click OK to 
insert the section in the current form. 


At insertion time, each section contains one blank line. Use the Edit - Insert 
Line After/Before functions to change the section size at any time while the 
cursor is in the work area of the section (below the section title line and above 
the next section title line). 
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Figure 61 
Select New Section dialog 





Define Section Parameters 


You can set runtime parameters for the section at the current cursor position. 
Choose Section - Edit Current to display an Edit Section Info dialog with 
check-boxes that let you set or clear section parameters. 


Figure 62 
Edit Section Info dialog 
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Select the appropriate check box to toggle parameter selection. The 
parameters include: 


e Advance Page Before Printing the Section: The section is printed at the 
top of the next page. 


e Advance Page After Printing the Section: Causes a printer Form Feed 
after this section. 


e Suppress Blank Lines: Causes blank lines not to be printed. 


e Trim Extra Spaces from Fields: If a field value is shorter than the field 
maximum length, this selection causes the field length to be truncated to 
the length of the value. 


Note: If you are using a columnar format, this parameter might cause 
misalignment of columns. 


Report Header / Footer 

These are printed only once, at the beginning/end of the report. The header is 
generally used as a title and description of the report. The footer might be 
used as a report summary. A report header and footer can contain free text and 
fields such as System Date and Time. 


Page Header / Footer 

These are printed at the top/bottom of every page in the report (beneath the 
Report Header on the first page and above the report footer on the last page). 
The header might contain text such as Report title, column headers and any 
other pertinent text as well as fields such as System Page Number, Date, and 
so on. The footer might be used for page numbers and page by page field 
totals or other pertinent data or text. 


Sort Header / Footer 


Each of these sections indicate a field that the report will use for a sort break. 
The field you choose is not printed. You can place text or fields or both text 
and fields at these section breaks to describe the sorts being used in the report. 


Detail Header 
This section contains a list of data for each record of the database, selected 
and sorted according to defined criteria. 
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Edit a Form 


Text and data are added at the current position of the cursor within the form. 
Move the cursor using the mouse or the keyboard arrow keys. The status line 
at the bottom of the window gives the cursor position by line (row) down and 
character (column) across. The <Ins> key toggles the insert/overtype mode. 
The status line indicates INS for insert mode (text moves everything to the 
right of the cursor to the right) or OT for overtype mode (text replaces existing 
text at the cursor position). 


Type to insert text. There is no automatic line wrapping. If you insert a 
carriage return (<Enter>), the cursor is returned to the beginning of a new 
blank line. 

You can use the Edit menu to move the cursor within a line, as follows: 

e Start of Line: left end of line 

* End of Line: right of the last character on the line 


e Next Word: first letter of the word to the right of the cursor 


e Previous Word: first letter of the word to the left of the cursor. 
To insert and edit a field at the current cursor position, use the Field menu. 


Insert a Field 


Choose Field - Insert New Field to display a submenu with a list of data field 
types to paste at the current cursor location. This option is not available when 
the cursor is positioned on a section separation line or on an existing field. 


The selected field appears at the current cursor location as a series of “x” 
symbols that represent the maximum number of characters in the field, as 
defined in the database. You can delete any number of field symbols to reduce 
the field length. To increase the field length, position the cursor on any field 
symbol except the first one, and type spaces. You can change the current field 
attributes by choosing Field - Edit Current Field. 
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Insert Data Field 


A data field is one field in each record of the current database. If you choose 
Field - Insert New Field - Data Field, a list of data fields is displayed in a 
Select Data Field dialog. See “Select Data Field” on page 85 for further 
details. 


Click OK to paste the selected field into the form at the current cursor 
position. 


Insert Calculation Field 


A Calculation field contains an expression that is a combination of data, 
functions, and operators. At runtime, the expression result is output for each 
record. You must supply a name for the field as well as the expression to be 
evaluated. The Field - Insert New Field - Calculation Field option first 
prompts you for the name of the field in a Calculation Field Name dialog. 


Figure 63 
Calculation Field Name dialog 
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You can enter up to 48 alphanumeric characters (not blanks) in the text box 
to represent the calculated field name. 


Click OK to enter an expression for the calculated field. The procedure for 
expression entry is the same as for "Define Selection Criteria" on page 84. 


Insert System Field 


A System field contains MAT system-dependent information, such as date, 
time, report page number, and record count. This information is typically in 
the report or page header or footer. One System field, WRAP OVERFLOW 
allows a data field to overflow to the next line or lines. For example, a 
comment field of 30 characters could contain 10 characters in the data field 
itself and ten in each of two WRAP OVERFLOW fields (generally placed 
directly under the data field itself). 
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If you choose Field - Insert New Field - System Field, a list of System fields 
is displayed in a Select System Field dialog. The procedure is the same as in 
“Select Data Field” on page 85. 


Click OK to paste the current highlighted field in the form at the cursor 
position. 


Edit Field Attributes 


This option, available by choosing Field - Edit Current Field, is used to edit 
the attributes for the current field. This option is available only when the 
cursor is positioned on a field. The field name is displayed in the status bar of 
the form window. The option displays a set of attributes that can be modified 
for the current field. You can modify the field attributes as needed. 


The attributes that you can modify depend on the type of field. Field types 
include: 


e Text (alphanumeric characters) 
e Numeric (numbers, including thousand separators and decimal point) 


e Date (date in predefined formats) 


Edit Text Field Attributes 


If the cursor is located within a text field and you choose Field - Edit Current 
Field, a Text Field Parameters dialog displaying the current attributes for the 
field appears. 


Figure 64 
Text Field Parameters 
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The following parameters can be modified: 


Field Alignment: By default, text data at runtime is left-aligned. You can use 
the radio buttons to select left, center, or right alignment. 


Wrap: If the field length on the form is too short to accommodate the data at 
runtime, you can select a wrap option to run the text toa WRAP_OVERFLOW 
System field that you have already defined. The Wrap option breaks at the 
end of the current field, and the Word Wrap option breaks at the end of the 
last word before the end of the field. The default attribute has no wrap option 
selected. 


Capitalization: By default, all text in the data field is printed as stored in the 
database. You can change this to all capitals, leading capitals, or all lower 
case, by selecting the appropriate check-box. 


Trim Extra Spaces: This check-box trims the field length to the length of the 
data that is entered at runtime. 


Note: If you are using columns, this option might cause columns to 
become misaligned. 


Edit Numeric Field Attributes 


If the cursor is located within a numeric field and you choose Field - Edit 
Current Field, a Numeric Field Parameters dialog displaying the current 
attributes for the field appears. 


The following attributes can be modified: 


Field Alignment: By default, numbers are left-aligned at runtime. You can 
use the radio buttons to select left, center, or right alignment. 


Number of Decimal Places: If the field contains a real number, this option 
lets you select the number of digits printed to the right of the decimal point. 


Currency Symbol: If the field represents money, you can use this option to 
define the currency symbol. 


Sign Representation: This option lets you select how to represent negative 


and positive number values. You can enter a character for prefix and suffix 
for both positive and negative numbers. 
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Figure 65 
Numeric Field Parameters dialog 
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Zero Values: Check the Suppress Zero Values check-box to suppress 
printing this field if it contains a value of zero. Check the Pad with Zeroes 
check-box if you wish to align the number to the right of the field and fill with 
leading zeroes. Check the Use Comma Format check-box to insert a comma 
between thousand values in the field. 


In addition to these attributes, you can edit the following attributes for fields 
that are located in the footer section of the report: 


Summarization Type: A numeric field in the footer could require the report 
to print a summary value. This option is a function selector that displays a list 
of possible summary values, such as total, average, maximum, minimum, or 
count. You can also print the actual value for the field by selecting Value. 


Retain Value After Printing: If the footer is a page footer, you can check this 
option to print "running" values instead of the value for each page. 


Edit Date Field Attributes 


Ifthe cursoris located within a Date field and you choose Field - Edit Current 
Field, a Field Name Edit dialog displaying the current attributes for the field 
appears. 
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Figure 66 
Date Field Edit dialog 
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You have a choice of four formats for the Date output, selectable by radio 
button: 


MMDDYY 
DDMMYY 
MMDDYYYY 
MMMDDYYYY 


You can also define the date delimiter by entering a required one-character 
delimiter in the Date Delimiter text box (/ or - , for example). 


Edit Calculation Field Expression 


This option is available only when the cursor is positioned on a calculation 
field and you choose Field - Edit Field Expression, or when you are first 
inserting a calculation field in the form. The option shows the existing 
calculation expression, if any, in a dialog and allows you to make 
modifications. The action of this dialog is the same as that for “Define 
Selection Criteria” on page 84. 


Setting Report Parameters 


The Forms Editor Options menu lets you set parameters for the report. These 
parameters are stored with the form and will be operative at runtime. 


The parameters are defined in a dialog when you choose Options - Report 
Parameters in the Forms Editor. Parameters include the following: 
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Figure 67 
Report Parameters dialog 


ME IE EE ET 


Hippo Hansa 
ro] | 


[ala Li sea 1 remm ad 
8 un mon FF justified Print 
[DDR kl fee V Pork: Trial Maciel 


Hapri achan) 


ua EEJ n E 


Tap [53 | Pelion [58 | 





Report Name: A text box that lets you enter up to 36 contiguous 
alphanumeric characters. This name is used in the MAT system as the name 
for the report and the form. This is not the same as the Windows filename. 


Default Date Format: A pair of radio buttons that lets you define the format 
in which dates are printed at runtime. The two formats are MM/DD/YY or 
DD/MM/YY. 


Print Trial Records: Run the report with just a few records. This enables you 
to check that the form generates a report with a suitable appearance and 
layout. 


Margins: Four text boxes that let you set the page margins. Enter numeric 
data only, and ensure that the page layout is valid. 


Character Formatting 


You can set the appearance of printed text using the Fonts menu. By default, 
text and fields are output in the Windows default font with Normal 
(unmodified) attributes. 


A selection from this menu acts on the selected data. To highlight data (text 
and fields) place the cursor at one end of the data to be highlighted, hold down 
the left mouse button and move the cursor to the other end of the data. To turn 
off highlighting, click anywhere in the form that is not highlighted. 
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Use the Fonts menu to display a list of character enhancements. Select one to 
print the highlighted text with that enhancement. Enhancements include the 
following: 


Superscript 


Normal, Bold, Underline, /talic, , Is 
Subscript 


When you apply an enhancement, highlighting is removed. If you desire more 
that one enhancement for any text, you must highlight the text again and 
select another enhancement. To remove an enhancement, highlight the text 
and choose Font - Normal. 


Font Selection 
Choosing Fonts - Fonts... brings up the Font Selection dialog box, from 
which you can select a font for the selected text. 


Figure 68 
Font Selection dialog 
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The Face Name box contains the name of the font for the selected text. A list 
box shows available fonts with the current font highlighted. Click the desired 
font to change the current font in the Face Name box. Use the arrows to help 
find the desired size, and click to select the font size. 


Click OK to set the highlighted text to the currently selected font and size. 


To use a single font for the entire report, select the font face and click the 
Default Font check-box. This becomes the Normal enhancement selection. 
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Report Criteria 


The Forms Editor Options menu lets you select criteria for record selection 
in the report. The criteria cannot be set at runtime, and are stored with the 
form in which the selection is made. The criteria are defined in an expression 
that displays in a Select Record Criteria dialog when you choose Options - 
Record Criteria. The action of this dialog is the same as for “Define Selection 
Criteria” on page 84. 


Building a Report in the MAT Report Generator - Form 
Editor 


Reports in MAT are built using report forms. The report form contains the 
information that allows the same report to be run repeatedly with new or 
updated data. The report form stores information that fully describes the 
report to the MAT software. A report form is comprised of several sections 
that describe different aspects of the report. A number of standard report 
forms are provided with the MAT software to provide some commonly used 
reports. 


This section describes a typical session to build a new report form. As an 
illustration, it produces a modified version of one of the MAT standard 
reports: Telephone Directory by Department. The report will print the 
department name once and print the station information for each department 
underneath the department heading. 


This section describes a step-by-step process to produce a report form. As you 
become more proficient using the Report Generator, you might find that you 
use a different series of steps to build or modify reports. Perform the 
following steps to build a report form: 

Decide what information needs to be displayed on the report. 

Select the Report View that best provides the information. 

Place the individual data fields on the report. 

Decide if the report lines should be sorted. 


Specify any special printer considerations for this report. 


Apply the finishing touches. 
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Save the report and test the results. 
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To work with Report Forms, start the Report Generator (choose File - 
Reports - Report Generator). Choose Form - New Report Format. This 
example shows how to create a new form. The report generator places an 
empty report form on the screen. 


Figure 69 
Empty Report Form 
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Decide what information needs to be displayed on the report 


As we will see in the next section, information in MAT is organized Into 
several logical databases. A report can use any one of these logical databases. 
There is also MAT system-dependant data that can appear on a report. This 
data includes date, system name, page number. Reports also can contain fixed 
text, typically headings or other constant text information. 
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Designing Report Forms 


In this example, we are using station information (as distinguished from 
CPND or VMB information). We can sketch out a rough picture of the report 
as a guide to what will fit on the page and how much heading information will 
be included. 


The basic model of the Report Generator is to read each record in the logical 
database, decide if it should be included in the report (according to the Report 
Filter). Some reports sort the records (according to the Sort Header sections). 
Finally, the records are printed. Some reports print out a line for each record 
included in the report (specified in the Detail section). Some reports print out 
summary information (specified in the Sort Header or Sort Footer section), 
such as the total number of particular instrument types. Some reports combine 
the detail and summary information 


Select the Report view that best provides the information 


After deciding to build a report focusing on station data, pick an appropriate 
Report View. Views provide alternative ways of looking at the data. Some of 
the report views describes the type of data. If the report describes CPND 
configuration information, then choose the CPND view; for CPND Name 
information (by Directory Number or Group) use the CPND Name view; for 
VMB information (by Directory Number) use the VMB view. 


Figure 70 
Select Report view 
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Station data is provided with some alternative views. If the report should print 
one line for each station, then choose the Station view. If the report should 
print one line for each Assigned Directory Number, then choose the Station 
DN view. If the report should print one line for each station key, then use the 
Station Key view. (In the Station Key view, single line information is 
included by assigning “pseudo key numbers” to the single line key features.) 
The SysSpdCall view is a special view primarily designed for the System 
Speed Call Report. It provides one record for each system speed call list user. 
If the report is selecting only certain records from the database or printing 
only summary data, then it will not actually print a line for each record, but 
the view describes how the selecting and sorting process examines the records 
in the database. 


Place the individual data fields on the report 


Once the Report View has been chosen and the basic design of the report has 
been defined, it is time to place the data on the report page. The Report 
Generator Forms Editor shows the current form broken into its logical 
sections. Initially the Page Header section and the Detail section are 
displayed. As other sections are incorporated into the form, they are displayed 
as well. In this example, the report contains the following sections: 


Page Header: This section contains the information displayed at the top of 
each page. Typically, it would contain the report title, the column headings 
over the data, the page number, the system name. 


Detail: The detail section describes the data items that would appear on each 
line in the body of the report. Typically, it would contain data from each 
record in the database that is included in the report. The data might be data 
items from the record or calculated fields built from the data fields. 
Calculations allow the report to create specially formatted names or other 
special expressions. 


Sort Header: The sort header sections (there can be several) describe how 
the lines in the report will be ordered. Sort 1 Header describes the primary 
sort, if two records have the same value for the sort field, then Sort 2 Header 
can be used to refine the order of the report. A report that should be ordered 
by name, might specify LastName in Sort | Header and FirstName in Sort 2 
Header. 
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It is often easier to design the report by specifying the Detail section first. This 
allows you to lay out the data on the page before placing the column headers. 
Treat the screen as a blank report page and position the cursor in the Detail 
section where the field should be placed. Choose Field - Insert New Field - 
Data Field to see a list of available data items. 


Figure 71 
Inserting Data Field in the Details section 
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Choosing Field - Insert New Field - Data Field displays a list of the fields that 
apply to this report view. This Select Data Field list will also appear in other 
situations where you need to select a field. Several data fields have been 
added specially to help produce reports and some fields have special 
meanings that affect their use in reports. Some examples of special reporting 
data fields include: 


ADN - All Directory Numbers: a list of all the Directory Numbers assigned 
to the station. This field creates a text field with the DNs separated by a space. 


ACDS: Keys Assigned to Automatic Call Distribution, showing both the 
ACD DN and Position ID. 


DN: This the Directory Number assigned to a single line station. The 
PRIMEDN field contains the Directory Number assigned to a single line 
station and the Directory Number assigned to Key 0 on multi-line station. 


Key features should be reported from the Station Key view and not from 
KEYGUPD or FTRGUPD. 


Use a calculated data field to tailor the information from the data record. To 
use a calculated field in a report, choose Field - Insert New Field - 
Calculation Field. A dialog appears, prompting you to name the newly 
calculated field. 


The Field Name dialog is followed by a dialog that allows you to construct an 
expression that performs the calculation. It can be built from existing data 
fields, functions, and operators. The following example constructs a field that 
contains “Last Name, First Name”. 


Note that the TRIM function is used to remove extra spaces and the “+” 
operator is used to concatenate the two fields. You can type the expression 
directly in the box or you can select the fields (from the Data Field or System 
Field buttons), the functions, and the operators. The expression will be built 
as the pieces are selected. 


Note that some functions apply to text fields and some functions apply to 
numeric fields. The Select Data Field list shows whether a field is numeric or 
text. In general, functions should not be applied to the System fields. 
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Figure 72 
Select Data Field dialog 
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Figure 73 
Naming a Calculation field 
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After the detail section has been specified, you can design the Page Header 
section. The text for the column labels can be placed over the appropriate 
data. The Page Header section often uses the System data fields: page 
number, system name, date, and time. Choose Field - Insert New Field - 
System Field to select one of these data fields. 
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Figure 74 
Defining a Calculation field 
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Figure 75 
System Field list 
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The Page, Date, Time, and System Name fields are commonly used in the 
Page Header section. We will discuss the other system fields in later in the 
section titled “Some Special Techniques". 


Decide if the report lines should be sorted 


Many reports require the data to be sorted. Since there is no sort information 
on a new report form, choose Section - New Section and select Sort 1 Header 
from the dialog. This will add a sort section to the report. 


The first sort section specifies the data field that provides the primary 
ordering of the data. The data value to use for sorting will be selected from 
the list of data fields. 
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Figure 76 
Select New Section 
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Other sort sections will be applied only to provide secondary order levels 
within the primary ordering. To order a report by alphabetizing the names of 
people in a department, the report should use Department for Sort 1 Header, 
LastName for Sort 2 Header, and FirstName for Sort 3 Header. 


Figure 77 
Select Data Field 
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To modify a Sort Header after it has been specified, choose Section - Sort 
Field. (It will only be available if the cursor is positioned in a Sort Header.) 


From this dialog, the Sort Field button again displays the familiar list of data 
fields. 
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Summary information can be specified in the Sort Fields, as well. On a report 
sorted by department, it is possible to print each department name once, by 
specifying the Department field in the Sort Header section (and not in the 
Detail section). 


Figure 78 
Adding summary information in the Sort Header section 
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The Sort Header section will print only when the Sort Header's field value 
changes. It uses the data field on the first record in the new sort group. 
Typically, the data field chosen to print in the Sort Header should be the same 
field on which the data are being sorted. 


Specify any special printer considerations for this report 


The Report Generator allows each report form to contain special printer 

information. Some reports might be designed to print in landscape mode, 
while others should print in portrait mode. Some reports might require a 

special printer, an impact printer with special forms, for example. 


Station Administration User Guide 


Page 164 of 194 Designing Report Forms 


Choose File - Printer Setup to select a printer and the Setup button to specify 
special information about the printer. 


Figure 79 
Selecting a printer 
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This information is stored with the form so that it applies each time the report 
is printed. When the Report Generator actually builds the report from the 
form and the data, you can override this printer information. 


Apply the finishing touches 


The Form Editor provides some additional capabilities to tailor the report. As 
you examine the almost complete report, you might wish to modify the 
appearance of the report. 
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Lengthening and Shortening Data Fields 

You can adjust the width of the data fields in the report. The area for each data 
field is marked on the form with the small letter 'x'. The data will be printed 
in that marked area. If the actual data are longer, they will be truncated to fit 
in the area; if they are shorter, the rest of the marked area will be filled with 
blanks. In the example report, you must lengthen the area set aside for the 
calculated field which holds the name. You might want to shorten a field in 
order to try to squeeze another field onto the report. 


To adjust the width of a data field, place the cursor in the marked area. To 
shorten the field, press <Delete> or <Backspace>. To widen the field, press 
any other key. It will appear on the form as the small letter 'x'. 


Adding and Deleting Blank Lines 

The Form Editor allows you to add and delete blank lines on the report. On a 
new form, the data in the Detail section is, by default, double spaced. To make 
a single-space report, position the cursor on the extra blank line and choose 

Edit - Delete Line. 


Figure 80 
Deleting a blank line from the Detail section 
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Other items in the Edit menu allow you to insert blank lines either above or 
below the line on which the cursor currently rests. 
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Report Parameters 

There are a few more options available to complete the report. Choose 
Options - Report Parameters to specify the name of the report as it will 
appear in the list of available reports. It also allows you to specify margins 
and other report -wide options. 


The Print Trial Records is used for reports that require that the paper be 
correctly aligned in the printer. It has no effect until you send the report to the 
printer. At that time, the Report Generator will ask whether it should print a 
Trial Report. The Trial Report contains the Header and Footer sections and a 
single line from the Detail Section. Each data field is replaced with a string of 
the letter 'X' of the appropriate length. You will be asked to print the Trial 
Report until you click No. This allows you to adjust the paper in the printer 
until it is properly aligned. Then the full report can be printed. 


Report Filter 

The Report Filter selects which records are to be included in the report. 
Choosing Options - Report Filter displays the Record Selection Criteria 
dialog. This dialog helps you to build an expression, typically from the data 
fields. As the Report Generator reads each record in the database, it evaluates 
the expression. When the expression is true, the record will be included in the 
report. 


Figure 81 
Specifying the records to be included in the report 
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The Record Selection Criteria dialog operates very much like the Calculation 
Field dialog. However, you should build an expression, usually including a 
comparison operator (=, >, <, <>). In the example, we are selecting all records 
for which there is a PrimeDN. The expression tests whether the PrimeDN 
field is not equal (<>) to blank (“ “). 


Modifying fields 
As part of the final tuning, you might want to specify more exactly how the 
fields are to be displayed. Choose Field - Edit Current Field. 


The Alignment options operate within the area of the data field, marked by 
the letter 'x'. The Wrap options should apply when the field will not fit in the 
area allowed. The section on “Some Special Techniques” discusses how to 
wrap text. Similar display options, like whether to use commas, control the 
printing of numeric fields. 


Save the report and test the results 


With the initial specification of the form complete, it is time to save the form 
and test it with the data from the system. Choose File - Save or File - Save 
As to save the form. Choosing File - Exit returns control to the Report 
Generator. To test the form, choose Report - Run Report to select the report 
form you wish to run. 


Figure 82 
Choosing the example form 
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The Select a Form File list uses the report names specified in the Form 
Editor's Option/Report Parameters dialog. If you did not specify a name for a 
new form, this list will display the file name. If you modified an existing form 
and saved it with a new file name but did not change the Report Name, that 
Report Name will appear twice. (You should go back into the Form Editor to 
give your modified report a new Report Name.) 


As you run the report, you might find that you wish to modify the form. From 
the Report Generator choose Form - Open Existing Report Formatto return 
to the Form Editor and modify the form. 


Some Special Techniques 


The following are a few special techniques available in the Form Editor to 
help you customize your reports: 


Sort Header section /Break Field 

If the cursor is placed in a Sort Header section, the Section - Break Field 
menu item is enabled. The Break Field is a data field that causes the Sort 
Header section and the Sort Footer section to print. By default (and almost 
always) the Break Field is the same as the Sort Field that was specified when 
the Sort Header section was created. 


Word Wrap 

If the data field will not fit in the area allowed for it on the form, you can 
specify that the field should wrap. By default, data which will not fit in the 
allotted space will be truncated. Wrapping is especially useful for a field like 
ADN (the list of all Directory Numbers assigned to a station), which can be 
either quite long or quite short. 


Wrapping the data field requires two steps: 


1 Mark the field as one that should be wrapped using the Field/Edit Current 
Field dialog. (Wrapping only applies to text fields.) Choose the Wrap Text 
box to cause the field to wrap at a word. 


2 Specify where to position the wrapped portion of the field. Position the cursor 
directly below the field that is to be wrapped and choose Field - Insert New 
Field - System Field. 
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You can include several overflow areas directly below each other. If you wish 
to include the line for the overflow only if it is needed, choose Section - Edit 
Current Section. This dialog includes an option to Suppress Blank Lines that 
will only print the line with the Wrap_Overflow field if it is used. 


Modifying a standard report 

If you choose to modify one of the standard reports distributed with MAT, 
you will notice that there are numbers in the headers, instead of text. These 
numbers allow the reports to translate automatically to another language. 


Figure 83 
Example Report 
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To see the actual text within the Form Editor, position the cursor on the 
octothorp character (#) and choose Field - View Field Translation. A box will 
display the text that will appear on the printed report. 
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A quick description of some section types not used in the 
example 

Sort Footer Section: Data fields placed in the Sort Footer section can be 
used like summary data in the Sort Header section. The fields in the Sort 
Footer section are only printed if the value changes (except that it prints after 
the detail lines). In addition, Sort Footer data can contain totals and other 
summary statistics. After placing a data field in the Sort Footer, you are 
prompted with a list that contains Value (to print the value from the last 
record in the group) or various summary statistics (include Total, Average, 
Count, Max, Min). These summary statistics also can be specified by 
choosing Field - Edit Current Field in the Footer Field box. 


Report Header, Report Footer: These sections can be used to specify 
data that should print only once at the beginning or the end of the report. 
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Power User Tool 


The standard MAT Station Administration window allows you to easily add 
or modify a few stations at a time. However, creating or maintaining large 
groups of stations quickly (as when establishing a new system) is better 
handled using the Power User tool. 


The Power User Forms window minimizes the actions required to add a 
station, eliminates up-front configuration of line cards and numbering plan, 
and allows you to create specialized installation forms that include only the 
station fields that you decide you need to configure stations. 


Note: At any time while using the Forms window, you can press <F1> 
for on-line reference information on the current field. 


Concepts for the Power User tool 


The concepts of forms, templates, and filters are important to understand 
before using the Power User tool. 


Forms and templates 


A form (a file that you can design) acts as a filter to determine which fields 
(of the hundreds possible) are displayed in the Power User Forms window for 
you to edit. When it’s time to use the form, you fill in the station values as 
needed for the first station, save them, and move to the form for the next 
station in the group that you are adding. You create a form file (a list of only 
those station-definition fields you wish to see in the order in which you want 
to see them) using the Forms Editor. 


A template places default values in some of these fields to save you the 
repetitive task of adding the same value to station after station. You create a 
template file (a partially filled-in station) using the template view in the 
Station Administration module. 
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Note: The function of templates is identical in the standard Graphical 
User Interface and the Forms Interface. 


This means that a form, used in conjunction with a template, provides you 
with a station-definition window including only those fields that you wish to 
edit, and with many fields already configured by the template with values of 
your choosing. 


To lessen clutter on the screen, the fields configured by the template are not 
displayed. This means that you work with only those fields which must be 
“personalized” for this station. You do not waste time moving through 
already-configured fields. 


You view and edit these station-configuration fields in the Forms Interface 
window. 


Filters 


There are hundreds of fields for a station, yet you are probably interested in 
only a few. The Form File that you define acts as a filter to allow only the 
fields of interest to appear in the forms interface station definition window. 


MAT automatically performs a second filtering to determine which of the 
station fields defined in the Form File actually apply to the current station. 
This applicability filter is based upon Meridian | system data (X11 software 
release, option packages, customer options) and the type of the current 
station. 


There are two important benefits to this applicability filter, as follows: 


* Form files are independent of systems, and, therefore, X11 software 
release, options packages, and customer options 


For example, a form file might contain fields that apply to release 20, but 
not to release 19. You can safely use this form with release 19 systems, 
since the release 20 fields will not be displayed. 


e Form Files are independent of station types 


A single Form File can include both single line FTR's and multi-line 
keys. If the form is used to display a single line station, then the FTR'S 
(but not the keys) are displayed. If the same form is used to display a 
multi-line station, then the keys (but not the FTR's) are displayed. 
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Using the power user Forms interface 


You use the Forms interface to add one or many stations to a system, as 
described in this section. “Designing forms and templates using the forms 
editor” on page 191 describes the process of creating forms and templates. 


Forms interface window buttons 


The following buttons appear at the top of the Forms interface window: 


OK: (Single station adds only) Saves the current station and closes the 
window. 


Next: (Multiple station adds only) Saves the current station, and opens 
the next blank station form. 


Previous: (Multiple station adds only) Saves the current station and 
opens the previously-created station. 


Cancel: Cancels any changes to the current station and closes the 
window. Any stations created before the current station while using this 
form are still in place. 


Validate: Validates all current station values. 


Print: Prints a a short form for the current station. This printout shows all 
values in the station, not just those on the form. (This is a quick way for 
you to check the value of a field not on the form.) 


Help: Opens Windows Help. 


Forms interface message bar 


The message bar at the bottom of the window has two panels. The left panel 
provides a description of the current field. The right panel displays hint text 
for the current field. For example, the hot keys to invoke the DN and TN lists 
where appropriate. 


Keyboard shortcuts 


In the procedures that follow, keyboard shortcuts are shown in brackets. 
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Adding a single station or template 


1 Choose Forms - Forms Interface. <INS> 


This is a toggled menu item. Clicking it places a checkmark next to the name 
(selects it), and clicking again removes the checkmark (deselects it). 


2 Choose Forms - Select Form. <Alt>O-S 


The Select Form dialog appears. This is a standard Windows file open dialog. 


Figure 84 
Select Form dialog 
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MAT provides the following example forms for you to use in creating forms 
that meet your needs: 


e ARIESDTA.SFM: designed for M2xxx and M3xxx data stations 


e VOICE.SFM: designed for all types of voice stations (single and 
multi-line) 


* Default form: A general-purpose form that includes most station 
fields. This is a good starting point for a form with many fields. You 
choose to use this form by selecting the Default Form check box. 


3 Select the form from the list box or select the Default Form check box. Click 
OK. 
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4 Choose View - Station to add a station or select Template to add a template. 
<Alt>V-S 


The existing stations (or templates) for the system appear in the MAT Station 
Administration window. 


5 Choose Edit - Add. <Ins> 
The Add Station dialog (or Add Template dialog) appears. 


Figure 85 
Add station dialog 
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6 If you are adding stations, follow these steps: 
* Enter “1” in the Number of Stations to Add field. 
* Select the Customer Number in the pull-down box. 
* Choose a template or instrument. 


If you choose a template, some fields will be filled in with the default 
values that you chose when designing the template. 


* Click the check boxes to automatically assign DN or TN, as desired. 


7 If you are adding a template, select a template from the list. 


Station Administration User Guide 


Page 176 of 194 Power User Tool 





Figure 86 
Add Template dialog 
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8 Click OK to open the Forms Interface window. 

The single station add form appears. 
9 Fill in the fields as described in “Station fields” on page 181. 
10 When you have entered all desired values, click OK. 

This saves the station and closes the forms interface window. 


11 For stations: If MAT is in Maintenance mode, the synchronization dialog 
appears. Fill in the dialog in the same way as with the standard interface. Click 


OK. 


To invoke synchronization manually if you are in Installation mode, use 
the Synch menu. 


Updating a single station (or template) 


1 Choose Forms - Forms Interface. «Alt» O-F 


This is a toggled menu item. Clicking it places a checkmark next to the name 
(selects it), and clicking again removes the checkmark (deselects it). 
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Figure 87 
Single station add form 
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2 Choose View - Station. <Alt>V-S 
(To modify a template, select Template. <Alt>V-T 


The existing stations (or templates) for the system appear in the MAT Station 
Administration window. 


3 In the MAT Station Administration window, double-click the station (or 
template) of interest. 


The single station add form (or the template add form) appears. 
4 Modify the fields as needed. 
5 Click OK. 
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For stations: If MAT is in Maintenance mode, the synchronization dialog 
appears. Fill in the dialog in the same way as with the standard interface. Click 


OK. 


To invoke synchronization manually if you are in Installation mode, use 
the Synch menu. 


Adding multiple stations 


1 
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Choose Forms - Forms Interface. <Alt>O-F 


This is a toggled menu item. Clicking it places a checkmark next to the name 
(selects it), and clicking again removes the checkmark (deselects it). 


Choose Forms - Select Form. <Alt>O-S 


The Select Form dialog appears. This is a standard Windows file open dialog. 
See Figure 84. 


MAT provides the following pre-defined forms: 
e ARIESDTA.SFM: designed for M2xxx and M3xxx data stations 


e VOICE.SFM: designed for all types of voice stations (single and 
multi-line) 


* Default form: A general-purpose form that includes all station fields. 
This is a good starting point for a form with many fields. You choose 
to use this form by selecting the Default Form check box. 


Note: MAT provides these pre-defined forms as starting points for your own 
special-purpose forms. You can create forms that include just the fields you 
need, and templates that set values that you define. See “Creating a new form” 
on page 191 and "Editing an existing form" on page 192. 


Select the form from the list box or select the Default Form check box. Click 


OK. 
Choose View - Station. <Alt>V-S 


The existing stations for the system appear in the MAT Station 
Administration window. 


Choose Edit - Add. «Ins» 
The Add Station dialog appears. 
Enter the number of stations that you wish to add. 


Select the Customer Number in the pull-down box. 
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8 Choose a template or instrument. 


If you choose a template, some fields will be filled in with the default values 
that you chose when designing the template. 


9 Click the check boxes to automatically assign DN or TN, as desired. 
10 Click OK to open the Forms Interface window. 


The multiple station add form appears. 


Figure 88 
Multiple station add form (default form) 
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11 Fill in the fields as described in “Station fields” on page 181. 
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12 When you have entered all desired values, Click Next. 


This saves the station and opens the next blank station form. The Next button 
changes to a Finish button while you edit the last station in the group. The 
Finish button saves the station and closes the forms interface window. 


13 If MAT is in Maintenance mode, the synchronization dialog appears. Fill in 
the dialog in the same way as with the standard interface. Click OK. 


To invoke synchronization manually if you are in Installation mode, use the 
Synch menu. 


Validating station data 


You can validate by field or by station, same as the standard interface. In 
addition, you have the option to relax numbering plan and hardware 
validations to ease the process of adding multiple stations at one time. 


Field validation 
The current field is automatically validated when you move to another field. 
If the validation fails, an error message appears, and the focus returns to the 
erroneous field. 


Station validation 


In the Forms Interface window, click Validate to validate all values for the 
station. This performs the same operation as when you choose File - 
Validation. 


Validating the numbering plan and hardware 


You can relax the numbering plan and hardware validations as follows: 


e Turn off numbering plan validation. This allows you to assign a DN not 
defined in the numbering plan, without generating an error. 


e Turn off hardware validation. This allows you to assign a TN for which 
there is no corresponding circuit card, without generating an error. 


Note: These validation settings affect both the forms interface and the 
standard interface. 
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Figure 89 
Mode dialog 
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Station fields 


This section provides detail on the station fields that you fill in using the 
Forms Interface. 


On-line Help 


At any time while using the Forms window, you can press <F1> for on-line 
reference information on the current field. 


Types of Station field 


The following basic types of station fields can appear in the Forms Interface: 


e Class of service 

e  Mutli-line keys 

e Single line FTR's 

e Prompts: These are all fields which do not fall into one of the above 


categories (for examples, TN, NCOS, and TGAR) 


Class of service field 


The Class of service control appears as a CLS text box which can contain 
multiple values (the approach taken by overlays 10 and 11). Enter all CLS 
mnemonics for this station in the CLS text box. 
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You can enter multiple mnemonics for the same class of service in the CLS 

text box (for example, CFXA and CFXD). In this case, whichever mnemonic 
appears last (furthest to the right) takes precedence. This is consistent with the 
operation of overlays 10 and 11. 


The values of some Class of service fields might not be visible on the form 
when it appears. Instead, the form shows only those classes of service which 
are not equal to default values. You can modify this partial configuration by 
adding new mnemonics or changing existing ones. 


Press <Fl> while within any class of service field for a complete list of class 
of service mnemonics in Windows Help format. 


Printing the class of service configuration 
The Print button on the form window allows you to print a short form which 
shows the complete class of service configuration. 


Mutli-line keys 


Keys for multi-line stations appear as drop-down boxes containing all key 
mnemonics. As you move through the list of mnemonics, the key description 
appears in the message bar at the bottom of the window. Additional parameter 
controls appear automatically if a mnemonic requires them (and for FTRs set 
to Yes). 


You can also type a mnemonic directly into the box. MAT tracks your typing 
and automatically enters the first matching key (and any associated parameter 
controls). 


Alternately, type the first letter of the mnemonic, followed by the down arrow 
key. The selection moves to the mnemonic starting with that letter. Press the 
down arrow key again to scroll down the list starting at that point. 


Single line FTR's 


FTRs appear as drop-down boxes containing the choices Yes and No. You 
can also type directly into the box. Additional parameter fields appear 
automatically if you set an FTR to Yes. When you move the cursor into a 
parameter field, the parameter description appears in the message bar at the 
bottom of the window. 
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Prompts 


Prompt fields appear as either drop-down lists or as edit boxes, depending on 
the type of the field. Fields with a small number of predefined values appear 
as drop-down lists (for example, FCAR and DTR). Numeric fields and other 
fields with a wide range of possible values appear as edit boxes (for example, 


DES and FDN). 


DN and TN fields 


DN and TN fields allow you to use lists of values to fill in the fields. In 
addition, extra fields appear as needed to allow you to enter parameter values. 


TN fields 


When you edit a fields with a TN type value, press <Ctrl>T (or 
double-click in the field) for a list of TNs compatible with the current 


station type. 


Figure 90 
TN value list 
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DN fields 


In addition to station fields, you need to modify fields that are not directly 
associated with the current station, but which are associated with DNs that 
appear on the station. You can use the following DN fields in the forms 


interface: 

e MARP 
e CPND 
e VMB 


Note: DN data is applicable to stations only, not templates. Therefore, 
the MARP, CPND, and VMB controls described below appear only on a 
form when operating on stations. Templates do not actually have DNs. 
Even if a template is configured with a fully specified DN, no DN record 
will be added to the database until a station is created using the template. 
Therefore, at the time a template is created, there is no way to store any 
DN data. 


Press <Ctrl> D while in a DN field (or double-click in the field) for a list of 
DNs. In the standard interface, MARP, CPND, and VMB appear as buttons 
on the DN list dialog. In the forms interface, MARP, CPND, and VMB appear 
as fields on the main form. 
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Figure 91 
DN value list 
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MARP 

The MARP drop-down list appears below the DN field with which it is 
associated. Multiple appearance DNs can have values of Yes or No. Single 
appearance DNs can have a value of Yes. The MARP field appears below the 
DN field of a single-line station and below the following multi-line keys: 


e MCN 
e MCR 
e PVN 
e PVR 
e SCN 
* SCR 


* HOT L 2WAY 

e HOT D 2WAY 
Note: The following Meridian 1 releases do not support MARP, 
therefore MARP does not appear on their forms: 

e North American releases 14 and 17 


e International release 16.9X G 


CPND 

The CPND name field is a single drop-down list (additional fields appear to 
the right if you choose a CPND value that requires them). See Figure 92. A 
CPND field appears below the DN field of a single line station, as well as 
below the following multi-line keys: 


e MCN 
e MCR 
e SCN 

* SCR. 
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You can choose one of the following values from the drop-down list: 


None: Performs no CPND operation 


Add: Creates a new CPND name (appears only if no name exists yet for 
the DN) 


Delete: Removes an existing CPND name 


Update: Modifies an existing CPND name 
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CPND Parameter Fields 


As you move the cursor into a parameter field, the parameter description 
appears in the message bar at the bottom of the window. The following 
parameter fields appear to the right of the CPND field when you choose 
a value other than None: 


Figure 92 
CPND parameter fields 
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e Get from location: drop-down list containing Yes and No 
e First name: text box 
e Last name: text box 


e Expected length: text box. This field is only added if the name has Synch 
Status NEW, and static allocation is enabled in the CPND Administration 
module. 


e Format: drop-down list containing FIRS and LAST 


e Language: drop-down list containing ROM and KAT. This field appears 
only if package 211 (Multi-language CPND) is enabled for the system. 
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Some additional attributes of the name controls follow: 


* Ifthe Get From Location field is Yes, then the First Name and Last Name 
controls are dimmed and disabled, and contain the name from the First 
Name and Last Name fields of the station. 


e Ifthe operation is Delete, then the additional name controls are dimmed 
and disabled. This allows you to view the name which is to be deleted, 
but not to modify it. 


Note: CPND depends on package 95 (Call Party Name Display). If 
package 95 is not enabled for a Meridian | system, the CPND field will 
not appear on the form. 


VMB 
VMB appears initially as a drop-down list (additional fields appear as 
needed). 


Figure 93 
VMB fields 
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A VMB appears below the DN field of a single line station, and below the 
following multi-line keys: 


e MCN 
e MCR 
e SCN 
* SCR 


The drop-down list contains the VMB operation to be performed, and allows 
the following values: 


e None: Perform no VMB operation 

e Add: Create a new VMB (appears only if no VMB exists yet for the DN) 
* Delete: Remove an existing VMB (appears only if a VMB does exist) 

e Update: Modify an existing VMB (appears only if a VMB does exist) 


If you select an operation other than None, then additional fields appear to the 
right of the VMB field. The additional fields are listed below in the order in 
which they will appear from left to right. 

e Class of service (text edit field) 

e Second DN (text edit field) 

* Third DN (text edit field) 


e Keep messages (drop-down list containing No and Yes). This control is 
only added if the voice mailbox has Synch Status NEW. 


As you select a VMB field, the description appears in the message bar at the 
bottom of the window. Additional parameter fields appear automatically if a 
VMB requires them. 


If the VMB operation is Delete, then the additional fields are dimmed. This 
allows you to view the VMB which is to be deleted, but not to modify it. 


Note: VMB depends on package 246 (Voice Mailbox Administration). 
If this package is not enabled for a Meridian 1 system, then the VMB 
fields do not appear on the form. 
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Designing forms and templates using the forms editor 


The MAT application assumes that station Form Files are located in the 
Common Data subdirectory, using a “.SFM” file extension. You can, 
however, place these form files anywhere you wish. 


MAT provides the following pre-defined forms: 


ARIESDTA.SFM: designed for M2xxx and M3xxx data stations 


VOICE.SFM: designed for all types of voice stations (single and 
multi-line) 


Default form: A general-purpose form that includes most station fields. 
This is a good starting point for a form with many fields. Instead of 
selecting this form in the file-selection box, you select this form by 
selecting the Default Form check box. 


Creating a new form 


To create a form, perform the following steps: 


1 
2 


Choose Forms - Forms Interface. <Alt>O-F 

Choose Forms - Edit Custom Form. <Alt>O-E 

The FormEdit dialog appears. 

Choose File - New to open a new form.<Alt>F-N 

The FormEdit window appears with no fields in the Form Fields list. 


From the Available Fields list, select the first field you wish to include in the 
form, and click Add. 


The field moves to the Form Fields list. 


Alternately, you can select one or several fields to drag from the Available 
Fields list to the Form Fields list. 


Move all the desired fields to the Form Fields list. 
To change the order of the fields, click and drag items up or down in the list. 


To remove an item from the list, click and drag from the Form Fields list to 
the Available Fields list, or select the item and click Remove. 
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Figure 94 
FormEdit window for a new form 
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6 When the Form Fields includes all the desired fields in the correct order, type 
a descriptive phrase in the Form Description text box. 


This is a phrase to help you remember the form's usage, not the filename. 
7 Choose File - Save to save the form file. <Alt>F-S 


The Save As window appears, allowing you to name the new form. Enter a 
filename and click OK. 


Alternately, to exit the forms editor without saving the form, choose File - 
Close. A warning box prompts whether you wish to save the changes before 
exiting the editor. 


Editing an existing form 


To edit an existing form, follow these steps: 


1 Choose Forms - Forms Interface. «Alt» O-F 
2 Choose Forms - Edit Custom Form. «Alt» O-E 


The FormEdit dialog appears. 
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3 Choose File - Open to install a form. <Alt>F-O 


The Select Form dialog appears. 


Figure 95 
Select Form dialog 
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MAT provides the following pre-defined forms: 
e ARIESDTA.SFM: designed for M2xxx and M3xxx data stations 


e VOICE.SFM: designed for all types of voice stations (single and 
multi-line) 


* Default form: A general-purpose form that includes most station 
fields. This is a good starting point for a form with many fields. You 
choose to use this form by selecting the Default Form check box. 


Note: The sample forms provided with MAT are a good starting point for 
many forms you might create. Be sure to rename the form when you save it, 
however. Subsequent versions of MAT will use the same default filenames, 
so any files you create using the default file names will be overwritten, and 
thus lost. 


4 Select the form from the list box. Click OK. 
The FormEdit dialog opens. 


5 From the Available Fields list, select the field you wish to include in the form, 
and click Add. 


The field moves to the Form Fields list. 


Alternately, you can select one or several fields to click and drag to move 
from the Available Fields list to the Form Fields list. 
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Figure 96 
FormEdit window (M2xxx and M3xxx data stations) 
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6 Move all the desired fields to the Form Fields list. 
To change the order of the fields, click and drag the item up or down in the list. 


To remove an item from the list, click and drag from the Form Fields list to 
the Available Fields list, or select the item and click Remove. 


7 When the Form Fields includes all the desired fields in the correct order, type 
a descriptive phrase in the Form Description text box. 


Note: This is a phrase to help you remember the form’s usage, not the 
filename. 


8 Choose File - Save As to save the modified form file. <Alt>F-A 


Alternately, to exit the forms editor without saving the form, choose 
File - Close. A warning box prompts whether you wish to save the changes 
before exiting the editor. 


P0876405 Standard July 1998 


